starred/librelyrics-spotify
1
0
Fork 0
mirror of https://github.com/libre-lyrics/librelyrics-spotify.git synced 2026-04-26 09:15:56 +03:00
Code Issues Projects Releases 1 Packages Wiki Activity
Spotify lyrics provider plugin for https://github.com/libre-lyrics/librelyrics.
3 commits 1 branch 2 tags 81 KiB
Find a file
Exact
Akash R Chandran 6b4ca32caa Bump version to 1.0.1 in pyproject.toml
2026-03-08 13:51:51 +05:30
.github/workflows Initial Commit 2026-02-22 00:40:15 +05:30
.gitignore Initial Commit 2026-02-22 00:40:15 +05:30
__init__.py Initial Commit 2026-02-22 00:40:15 +05:30
api.py Initial Commit 2026-02-22 00:40:15 +05:30
LICENSE Initial Commit 2026-02-22 00:40:15 +05:30
module.py Initial Commit 2026-02-22 00:40:15 +05:30
pyproject.toml Bump version to 1.0.1 in pyproject.toml 2026-03-08 13:51:51 +05:30
README.md Initial Commit 2026-02-22 00:40:15 +05:30
totp.py Updated SECRET_CIPHER_DICT_URL 2026-03-08 13:26:06 +05:30

README.md

librelyrics-spotify

Spotify lyrics provider plugin for LibreLyrics.

Features

  • Fetch synced and unsynced lyrics from Spotify
  • Support for track, album, and playlist URLs
  • TOTP-based authentication with Spotify's internal API

Installation

pip install librelyrics-spotify

Configuration

Requires a Spotify sp_dc cookie. Set it up via:

librelyrics config edit

Or set it directly:

librelyrics config set plugins.Spotify.sp_dc "YOUR_SP_DC_COOKIE"

Getting your sp_dc cookie

  1. Open Spotify Web Player in your browser
  2. Log in to your account
  3. Open Developer Tools (F12) → Application → Cookies
  4. Find the sp_dc cookie and copy its value

Supported URLs

  • https://open.spotify.com/track/<id>
  • https://open.spotify.com/album/<id>
  • https://open.spotify.com/playlist/<id>

Usage

Once installed, the plugin is automatically discovered by LibreLyrics:

librelyrics "https://open.spotify.com/track/4PTG3Z6ehGkBFwjybzWkR8"

License

GPL-3.0-or-later