Skip to main content

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.

LiveLyrics is a single Python script with two pip dependencies — requests and winsdk — and requires Windows 10 or 11. There is no package to install from PyPI and no build step; you simply grab the script, install the dependencies, and drop in your Discord token.
1

Verify Python

Open a PowerShell or Command Prompt window and confirm you have Python 3.8 or newer:
python --version
You should see output like Python 3.11.4. If Python is not installed or the version is below 3.8, download the latest release from python.org before continuing.
2

Install dependencies

Install both required packages with a single pip command:
pip install requests winsdk
requests handles all HTTP calls to LRCLIB and the Discord API. winsdk provides the Windows SDK bindings needed to read the active media session from the OS.
3

Download the script

Clone the repository or download LiveLyrics.py directly from GitHub:
git clone https://github.com/x-eon-max/LiveLyrics
Alternatively, visit github.com/x-eon-max/LiveLyrics and download the raw LiveLyrics.py file. No other files from the repository are required at runtime.
4

Obtain your Discord token

LiveLyrics authenticates to Discord using a user token — this is the credential your own Discord client uses, not a bot token. Follow the guide at the link below to locate yours:How to get your Discord token
Your Discord user token grants full access to your account. Never share it, commit it to a public repository, or post it anywhere online. Anyone who holds your token can read your messages, join servers, and modify your account on your behalf.
5

Set the TOKEN variable

Open LiveLyrics.py in any text editor and replace the placeholder value at the top of the file with your actual token:
LiveLyrics.py
TOKEN = 'YOUR-TOKEN-HERE'  # Replace with your actual token
Save the file. This is the only configuration change required before running the script.
winsdk is a Windows-only package that wraps the Windows Runtime APIs. The script will not run on macOS or Linux — those platforms do not expose the GlobalSystemMediaTransportControlsSessionManager interface that LiveLyrics depends on.

Build docs developers (and LLMs) love

Get started for freeTalk to us