Skip to content

Findings and fixes

Every finding names the source behind it, and most carry a fix you can preview.

Read a finding

LyricLint checks the lyrics as you type and lists what it finds in the Review tab of the right panel. The same findings are underlined in the lyrics.

The Review tab with one finding expanded. It shows the message, the line number and cited source, an explanation, and a fix button, while the lyrics show the fix as a preview.

When several findings ask the same question, such as ten lines that end in a comma, the list shows them as one decision with ten places, and you work through its places.

Each decision in the list starts with one line of facts:

  • A mark for how serious it is (see the table below).
  • The line it is on. A decision with several places says how many instead, such as 10 places, and the place you have open names its line, such as Place 2 of 10, line 9.
  • The source it relies on, as a link. Point at the link or focus it to see which part of the page is cited and when LyricLint last checked it. When a finding cites several sources, they fold behind Sources.

Some findings also say LyricLint reading. That marks a check that is LyricLint's own interpretation of the sources cited after it, rather than something a source states outright.

Severity Mark What it means
Error Cross in a circle The markup is broken, such as an unclosed bracket or a performer tag Genius does not support.
Warning Exclamation mark in a triangle The lyrics depart from a reviewed Genius convention.
Suggestion i in a circle A judgment call or readability preference. Worth a look, and often fine to leave.
Manual review Check mark in a circle LyricLint cannot tell whether this is right, such as a custom section header. Check it yourself.

The chips above the list (Errors, Warnings, Suggestions, Manual review) show how many decisions of each kind there are in the list, counting a decision with several places once. Press a chip to hide or show that kind. The list keeps its order while you work through it, and sorts itself again when you press a chip or come back to the Review tab.

Press a decision in the list to open it and read the explanation. A decision with several places opens on its first place, and Place 1 of 10, line 8 under its line of facts steps to the others with Previous place and Next place. In the lyrics, point at an underline to see the same finding in a popover. When a line has several findings, a count at the end of the line lists them.

To move between findings from the keyboard:

  • In the lyrics, F2 goes to the next place with a finding and ShiftF2or ShiftF2on a Mac to the previous one.
  • In the Review tab, use Previous and Next, or AltShiftUp arrowor OptionShiftUp arrowon a Mac and AltShiftDown arrowor OptionShiftDown arrowon a Mac, to move from one decision in the list to the next. Each opens on its first place; Previous place and Next place reach the rest.

Each of LyricLint's own checks has a page in the transcription guide with examples and the reasoning behind it.

Apply a fix

When you open a finding that has a fix, the lyrics show the fix as a preview: struck-out text for what goes, and new text for what arrives. Nothing changes until you choose.

  1. Open the finding in the Review tab, or point at its underline.
  2. Read the preview. The fix button is labelled with the change itself, such as Replace with I'ma.
  3. Press the button.

The fix is one step you can undo, and the next finding opens so you can keep going. In a decision with several places, its next place opens in the same spot. When a finding offers more than one fix, the first is the recommended one. Point at or focus any of them to preview it.

From the keyboard, Ctrl.or Command.on a Mac opens the nearest finding that has a fix, with its fix button focused. Press Ctrl.or Command.on a Mac again to apply it.

Some findings need a choice rather than a replacement, so they carry a different button:

  • Choose header opens the section header picker.
  • Assign section performers opens the performer picker.
  • Manage linking opens the Linking panel.
  • Set language to … changes the 'scribe's lyric language.

A finding with no button explains what to change, and leaves the change to you.

Fix every occurrence

When the same fix applies in several places, a Fix all button appears beside it with the count, such as Fix all 3. It applies that exact change, from that check, everywhere it appears, as one step you can undo.

At the top of the Review tab, Fix … issues automatically applies every such fix in the list at once. Its count is the number of places it changes. The note beside it counts the decisions in the list that will still need you afterwards, such as 2 decisions left.

Both use only fixes that were reviewed as safe to apply without looking at each one. Fixes that need your judgment are applied one at a time. Findings you have hidden with the chips are left alone.

Ignore a finding

If a finding is wrong for this song, press Ignore. It disappears for this 'scribe only, and a message offers Undo. In a decision with several places, Ignore sets aside only the place that is open.

An ignored finding stays hidden even if you delete the text and type it again later. Other 'scribes still show it.

Some findings ask a question instead, and answering it hides the finding in the same way:

  • It's correct, for a custom section header you meant to use.
  • It really is unintelligible, for an unknown-lyric marker.
  • The performer is unknown, for a styled voice you cannot name.

To bring one back, open the ignored list at the foot of the Review tab (it reads, for example, “2 diagnostics ignored”). Each entry shows where it is, and Restore returns it to the list.

Grammar and spelling

For English lyrics, LyricLint also checks spelling and grammar with Harper, a proofreader that runs in your browser. Your lyrics are not sent anywhere for this.

Lyrics bend grammar on purpose, so every Harper finding is a Suggestion and cites Harper as its source. Harper findings are listed after LyricLint's own, and their fixes are applied one at a time, never in bulk.

Harper is tuned for lyrics:

  • Names on the roster count as known words.
  • Dropped endings written with an apostrophe, such as runnin', are left alone.
  • Checks that would contradict Genius conventions, such as censoring words or regional spellings, are off.
  • Where one of LyricLint's own checks covers the same words, only that finding shows.

To turn it off, switch off Grammar checking in Preferences. The switch appears while the lyric language is English.