LiveLyrics is a lightweight Python utility that watches your Windows audio session, fetches time-synced lyrics from LRCLIB, and updates your Discord custom status line-by-line as the song plays. No plugins, no browser extensions — just a single Python script.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/x-eon-max/LiveLyrics/llms.txt
Use this file to discover all available pages before exploring further.
Introduction
Learn what LiveLyrics does and how the three core systems fit together.
Quickstart
Install dependencies, set your token, and have lyrics flowing in under five minutes.
How It Works
Deep-dive into media detection, lyrics parsing, and Discord status updates.
Configuration
All configurable values and what each one controls.
What LiveLyrics Does
Detects the playing track
LiveLyrics uses the Windows SDK media session API to read the title and artist of whatever is currently playing — Spotify, Windows Media Player, a browser, or any other audio source.
Fetches time-synced lyrics
It queries the LRCLIB API for
.lrc-formatted lyrics, then caches the result so repeated plays skip the network round-trip.Matches lyrics to playback position
A temporal extrapolation algorithm corrects for the gap between the OS-reported playback position and the real-time clock, keeping the displayed line accurate even under load.
LiveLyrics runs entirely on your local machine. Your Discord token and lyrics data never leave your system except for the two API calls described above.