Skip to content

About

Live song lyrics → your Discord custom status. No API keys. Works with Spotify, browsers, VLC.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

Repository files navigation


Node.js .NET Windows Discord


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.



✨ Features

  • 🎵 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:3030 showing the current track, live lyric, progress bar, and settings
  • ⚙️ Settings — toggle lyric push on/off, clear status on pause, add a song title prefix

📸 Preview

Dashboard running in browser while Spotify is playing

image

🔧 Requirements

Tool Version Link
Windows 10 or 11 —
Node.js 18 or newer nodejs.org
.NET SDK 8.0 dotnet.microsoft.com

🚀 Setup

1. Clone the repo

git clone https://github.com/Kh8da/lyric-status.git
cd lyric-status

2. Double-click start.bat

That'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:3030 in your browser

3. Add your Discord token

Open the dashboard → Settings tab → paste your Discord user token → Save token.

How to find your Discord token

First Method:

  1. Open Discord in your browser or desktop app
  2. Press F12 to open DevTools
  3. Go to the Network tab
  4. Filter by science
  5. Click any request → Headers → copy the value next to Authorization

Second Method:

  1. Open Discord in (Browser)
  2. Press F12 to open DevTools
  3. Go to the Application tab
  4. Open local storage and select https://discord.com
  5. Scroll down till you find token
  6. 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.json and never leaves your machine.


🎤 Lyrics

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.


⚙️ Settings

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 —

📁 File Structure

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

❓ FAQ

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.


🛠️ Manual Build (if start.bat doesn't work)

:: Install dependencies
npm install

:: Build the track helper
dotnet build get-track.csproj -c Release -o track-helper

:: Start the server
node src/server.js

Then open http://127.0.0.1:3030.


Made by kh8da

About

Live song lyrics → your Discord custom status. No API keys. Works with Spotify, browsers, VLC.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages