Back to projects
Web App
LyricFlow
Web music player with synchronized real-time lyrics and audio spectrum visualizer
Next.js 16React 19Tailwind CSS 4shadcn/uiWeb Audio API
The Problem It Solves
- Need for a web music player with synchronized real-time lyrics.
- Support for multiple lyric tracks (original, translation, etc.).
- Audio spectrum visualization with multiple modes and themes.
Key Features
- Real-time synchronized lyrics display with binary search optimization.
- Multiple lyric tracks (original, translation, etc.) via
track_order. - Per-line styling (color, typography, shadows, gradients, transitions).
- Audio spectrum visualizer with 3 modes (bars, wave, mirror).
- 6 predefined visual themes + custom theme import via JSON.
- Per-song backgrounds (solid color, dynamic mode, image, or video).
- Playlist panel with search and navigation.
- Local file upload support (audio + JSON) directly from browser.
- Song import pipeline with LRCLIB integration.
- Automatic lyrics fetching and song.json generation.
Technical Decision
- Separate playback logic from UI to facilitate testing and maintenance.
- Use Web Audio API for real-time audio spectrum visualization.
- Prioritize user experience with precise lyrics synchronization.