Lyrics Sync Agent

AI-powered tool for automatic synchronization of song lyrics with audio.

Features

• automatic vocal transcription
• word-level timestamps
• lyrics-to-audio alignment
• recovery of missing lyric lines
• repeated-line detection
• TTML and LRC export
• web interface for uploading audio and lyrics

How It Works

Audio + Lyrics
↓
Transcription
↓
Word-level timestamps
↓
Lyrics Alignment Agent
↓
Timing correction & recovery
↓
Synchronized lyrics
↓
TTML / LRC

Architecture

Frontend → Backend API → Transcription → Alignment → TTML/LRC

Tech Stack

• Python
• FastAPI
• Faster-Whisper
• JavaScript
• HTML / CSS
• TTML / LRC

Installation

Clone the repository:

git clone https://github.com/julllyum/lyrics_sync_agent.git
cd lyrics_sync_agent

Create a virtual environment:

python -m venv .venv
source .venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Running the Application Start the backend:

python backend/api.py

The application will be available at:

http://127.0.0.1:8000/

Open the URL in your browser. The frontend is served directly by FastAPI, so no separate frontend server is required.

:)

Project UI

Upload

Processing

Lyrics Editor

Lyrics.Sync.mov