๐ต ELYSY | Eliz's Lyrics Synchronizer
AI-powered word-by-word lyrics synchronization โ free, open source (MIT) and 100% local.
Everything you need for karaoke-perfect lyrics
Upload a song, paste or import its lyrics, and let AI do the timing โ then fine-tune every word by hand.
AI Auto-Align
Demucs isolates the vocals, WhisperX produces word-level timestamps, and a matcher maps them onto your exact lyrics โ preserving every line and word.
Manual Tap + AI
Tap Space at each line boundary, review and nudge the timing, then let AI refine word timing inside your tapped windows. Ideal for distortion or unusual phrasing.
Word precision controls
Hover any word for ยซ < 00:23.45 > ยป buttons that nudge by ยฑ0.1 s / ยฑ0.3 s โ with audio preview at that exact spot.
Undo / Redo
50-step history with Ctrl+Z, Ctrl+Shift+Z, Ctrl+Y and on-screen buttons. Also multi-line select with batch shift.
Projects
Save, Save As New and Load โ self-contained project folders (audio + JSON) that you can move or back up freely.
Import LRC
Load existing .lrc files (standard or enhanced) to fix, re-time and upgrade them instead of starting from scratch.
5 export formats
Enhanced LRC, Enhanced SRT (word-by-word captions), Standard LRC, SRT and JSON โ all with distinct filenames.
Local & private
Runs entirely on your machine. Your audio and lyrics never leave your computer. No accounts, no cloud, no tracking.
Two workflows, one perfect result
๐ค Mode 1 โ AI Auto-Align (fastest)
Drop your audio
MP3, WAV, FLAC, OGG or M4A โ up to 100 MB.
Paste or import your lyrics
One sentence per line โ or click Import LRC to load an existing file.
Click Auto-Align
Wait ~30โ90 s on a GPU (a few minutes on CPU).
Review
Play the song โ words highlight as they are sung. Hover any word to adjust its timing.
Export
Enhanced LRC, Enhanced SRT, Standard LRC, SRT or JSON.
๐ Mode 2 โ Manual Tap + AI (most precise)
Upload audio + paste lyrics
Then switch to Manual Tap mode.
Start tap recording
Press Space at the start of each line as the song plays.
Review the line timing
Nudge any line with ยซ < > ยป or clear a mistap before continuing.
Refine words with AI
Word timing fills inside your tapped line windows.
Fine-tune & export
Adjust individual words, then export the format you need.
The pipeline under the hood
Four stages turn raw audio + lyrics into perfectly synced files:
Demucs โ Vocal separation
AI source-separation isolates the singing voice from the instruments for far better accuracy.
WhisperX โ Forced alignment
Whisper large-v3 transcribes; wav2vec2 aligns to phonemes for word-level timestamps.
Matcher โ Lyrics mapping
Sequence alignment maps detected words onto your known lyrics, preserving every original line and interpolating anything missed.
Generator โ Export
Produces Enhanced LRC, Enhanced SRT, Standard LRC, SRT or JSON.
System requirements
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 8 GB | 16+ GB |
| GPU | None (CPU works) | NVIDIA 8+ GB VRAM (RTX 30/40/50) |
| Disk | 8 GB free | 12 GB free |
| Python | 3.10+ | 3.11 or 3.12 |
| OS | Windows 10/11, macOS, Linux | Windows 11 |
Move fast without touching the mouse
| Key | Action |
|---|---|
| Space | Play / Pause (or tap in manual mode) |
| โ โ | Seek back / forward 3 s |
| โ โ | Seek back / forward 1 s |
| Enter | Run Auto-Align |
| Esc | Cancel tap mode |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z / Ctrl+Y | Redo |
| Ctrl/Cmd + click (line) | Multi-select lines for batch shift |
| โฎ | Seek to start |
Common issues, solved
| Problem | Solution |
|---|---|
| "CUDA not available" | Update NVIDIA drivers; re-run install.bat (CUDA 12.8 build). |
| Demucs slow / fails | Disable "Vocal separation" โ alignment still works on the full mix. |
| Words missing or dotted | They are estimated โ hover and nudge, or use Manual Tap mode. |
| Repeated chorus mis-timed | Auto-fixed by the monotonic pass; if not, nudge those lines manually. |
| Edits don't appear in export | Edits sync automatically; if unsure, Save then re-export. |
| Server won't start | Port 8765 busy? Run python backend\app.py --port 8777. |
| Install file-lock errors | Close the server + VS Code, pause Dropbox/antivirus, re-run install. |
ELYSY ยท MIT Licensed ยท Built with โค๏ธ for musicians, named after Eliz ๐ค
