DEV Community

Mavos.by.Kyklos
Mavos.by.Kyklos

Posted on

Lyrisee How-To: Fix Transcription Errors With the Lyric Editor

If you've run a song through Lyrisee and a few words came out wrong — "veins" became "vains", an artist name got mangled, a slang term got autocorrected — the lyric editor lets you fix it without re-processing.


Opening the Editor

After processing completes, click ✎ Edit lyrics in the top right of the controls panel.

The editor opens as an overlay with one row per line. Each row shows:

  • Time — the line's start timestamp (editable)
  • Text — the transcribed words for that line (editable)
  • Delete — remove a line entirely

Fixing a Mis-Transcribed Word

Click the text field for any line and edit it directly.

Before: "pain is all i fill i got nothing to gain"
After:  "pain is all I feel I got nothing to gain"
Enter fullscreen mode Exit fullscreen mode

The corrected words get re-aligned to the original word-level timestamps automatically using difflib.SequenceMatcher. If you replace one word with one word, it inherits the original timing exactly. If you replace two words with three (or vice versa), the time window is split evenly across the new tokens.


Nudging a Line's Start Time

Sometimes Whisper starts a line a fraction of a second early or late. Click the time field and adjust:

12.480  →  12.600
Enter fullscreen mode Exit fullscreen mode

All words within that line shift by the same delta.


Adding or Removing Lines

Use the + Add line button at the bottom to insert a line with a manual timestamp and text. Use the button on any row to remove it.

This is useful when Whisper splits a line mid-phrase or merges two lines into one.


Applying Changes

Click Apply & re-render. The canvas updates immediately — no re-processing, no waiting. The typography engine replays with your corrected text and preserved timing.


Downloading the Corrected Lyrics

Click Download to save a lyric_data.json with your corrections. Next session, load the audio file and then drag in the saved JSON — it skips the whole processing pipeline and goes straight to playback.


Tips for Common Cases

Rap slang and AAVE
Whisper sometimes over-corrects. If "finna" became "going to", the AI repair should have caught it — but if not, fix it in the editor. The POS tagger re-runs on edited text, so "finna" will get the right grammatical role.

Artist names and proper nouns
Whisper often mishears names. Fix in the editor — capitalized words automatically get PROPN tagging, which affects styling (they render with slightly different weight).

Sung words vs spoken words
If a word was held for 2 seconds and Whisper assigned it a 0.1s window, you can't fix that in the text editor — but it's rare. The word will still appear at the right moment; it just exits earlier than the hold lasts.

Background vocals and ad-libs
Whisper picks up background vocals. If you don't want them, delete those lines in the editor.


Open Lyrisee → https://acecalisto3-lyrisee.hf.space

Top comments (0)