Lyric Status reads what you're playing through Windows, fetches time-synced lyrics automatically, and pushes each line to your Discord custom status in real time — no Spotify API key, no third-party accounts, no setup beyond pasting your Discord token.
- 🎵 No API keys — reads the current track directly from Windows Media Transport Controls (SMTC), so it works with Spotify, browsers, VLC, or any media player
- 🎤 Auto lyrics — searches LRCLib automatically by artist name and song title, picks the best synced match
- ✏️ Manual override — search LRCLib yourself or paste your own LRC-format lyrics if auto-fetch gets it wrong
- 💬 Real-time Discord status — each lyric line is pushed to your Discord custom status as it plays, ~100ms accuracy
- 🖥️ Local dashboard — clean green & black web UI at
http://127.0.0.1:3030showing the current track, live lyric, progress bar, and settings - ⚙️ Settings — toggle lyric push on/off, clear status on pause, add a song title prefix
Dashboard running in browser while Spotify is playing
| Tool | Version | Link |
|---|---|---|
| Windows | 10 or 11 | — |
| Node.js | 18 or newer | nodejs.org |
| .NET SDK | 8.0 | dotnet.microsoft.com |
git clone https://github.com/Kh8da/lyric-status.git
cd lyric-statusThat's it. The batch file will:
- Check that Node.js and .NET are installed
- Install npm dependencies automatically
- Build the C# track helper (
get-track.exe) - Start the server and open
http://127.0.0.1:3030in your browser
Open the dashboard → Settings tab → paste your Discord user token → Save token.
How to find your Discord token
First Method:
- Open Discord in your browser or desktop app
- Press F12 to open DevTools
- Go to the Network tab
- Filter by
science - Click any request → Headers → copy the value next to
Authorization
Second Method:
- Open Discord in (Browser)
- Press F12 to open DevTools
- Go to the Application tab
- Open local storage and select https://discord.com
- Scroll down till you find token
- Copy the value — that's your token
⚠️ Your token is the password to your account. Never share it, never paste it anywhere except this app. The token is stored locally in.config.jsonand never leaves your machine.
Auto mode — when a new song starts, Lyric Status automatically searches LRCLib using the artist name and track title, runs three parallel queries, scores all results, and applies the best synced match.
If auto-fetch gets it wrong:
Go to the Lyrics tab in the dashboard:
| Option | What it does |
|---|---|
| Search | Search LRCLib manually with any query, see scored results, click "Use this" |
| Manual editor | Paste LRC-format lyrics with timestamps ([0:12.34] Line text) or plain text (auto-spaced 3s apart) |
Lyrics are saved locally in .lyrics.json and reused instantly on repeat plays.
| Setting | Default | Description |
|---|---|---|
| Lyric status | ✅ On | Push each lyric line to your Discord custom status |
| Clear on pause | ✅ On | Remove the Discord status when playback pauses |
| Title prefix | ❌ Off | Prefix each line with ♪ Song Title — |
lyric-status/
├── src/
│ └── server.js ← Node.js backend (track polling, lyrics, Discord)
├── public/
│ ├── index.html ← Dashboard UI
│ ├── app.css ← Styles (green & black theme)
│ └── app.js ← Frontend logic
├── track-helper/ ← Built .exe lives here after first run
├── get-track.cs ← C# source — reads SMTC track info
├── get-track.csproj ← .NET project file
├── start.bat ← One-click launcher (run this)
├── package.json
├── .config.json ← Auto-created — stores your token & settings
└── .lyrics.json ← Auto-created — lyrics cache
Does it work with Spotify Free? Yes. It reads the track from Windows, not from Spotify's API, so no account tier matters.
Does it work with YouTube / browsers? Yes. Any media player that registers with Windows SMTC works — Spotify, Chrome, Edge, Firefox, VLC, foobar2000, etc.
Will Discord ban me for using a user token? Using a user token for automation is against Discord's ToS. This tool only updates your custom status — a single PATCH request per lyric line — which is the same thing you'd do manually. Use at your own discretion.
Lyrics are wrong / not loading? Go to the Lyrics tab and use the search box to find the correct LRCLib entry, or paste your own LRC file in the manual editor.
How do I run it on startup?
Press Win + R, type shell:startup, press Enter, then copy a shortcut to start.bat into that folder.
:: Install dependencies
npm install
:: Build the track helper
dotnet build get-track.csproj -c Release -o track-helper
:: Start the server
node src/server.jsThen open http://127.0.0.1:3030.
Made by kh8da