Spicy Lyrics is an Extension made for Spicetify - A Spotify Client modifier
See the code
Spicy Lyrics replaces Spotify's lyrics view with animated lyrics, dynamic backgrounds, romanization, and customization options. It is an open-source extension for the Spotify desktop client, built on Spicetify.
Links: Guides · FAQ · Status · Discord · Developers Platform
Spicy Lyrics runs only in the Spotify desktop client, through Spicetify. It does not need Spotify Premium.
Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
macOS / Linux (Terminal):
curl -fsSL https://raw.githubusercontent.com/spicetify/cli/main/install.sh | sh
[!WARNING] Spicetify cannot modify a Snap-based Spotify installation on Linux. See the official Spicetify guide for other setups.
Look for the Marketplace button in Spotify's top-left corner. If it's missing, install it:
Windows:
iwr -useb https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.ps1 | iex
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.sh | sh
Play a song and open the lyrics view to confirm it loaded. Marketplace installs update automatically; restart Spotify if a new version hasn't appeared.
spicy-lyrics.mjs.spicetify config extensions spicy-lyrics.mjs
spicetify apply
Manual installs don't update automatically.
If Spicy Lyrics disappears after a Spotify update or fails to load, try these in order:
spicetify apply
spicetify backup apply
spicetify update
spicetify restore backup apply
Lyrics missing, outdated, or wrong?
High CPU or memory use? Animated lyrics, dynamic backgrounds, themes, custom CSS, and other extensions all add load. Restart Spotify, test without other extensions or snippets, and check Spotify's hardware-acceleration setting.
Search #extension-bugs first. If it's new, include:
[!CAUTION] Never share account tokens, cookies, authorization headers, or other secrets in a bug report.
Security issues go through SECURITY.md, not public channels.
| Type | What it does |
|---|---|
| Word-synced | Highlights individual words, or timed parts of words, as they're sung. |
| Line-synced | Advances one timed line at a time. |
| Static | Shows lyrics without timing. |
The sync type depends on the lyric data available for that exact track. There's no setting to turn line-synced lyrics into word-synced ones.
Community-uploaded TTML lyrics first, then other supported sources, including Apple Music and Spotify. What you see depends on availability, matching, and source priority.
No. The extension runs in Spotify's desktop client only.
Spicy Player is a separate offline Android music player by TX24 that ports the Spicy Lyrics experience. It is not a Spotify mobile extension.
Online lyric lookup needs an internet connection. Lyrics you import into the Lyrics Manager's persistent local library stay on your device until you remove them.
Yes. Open the Lyrics Manager and import the TTML as a temporary upload (for quick testing) or a persistent one (kept in your local library). There's no setting for adding other online lyric providers.
If one song is off, the lyric file may have been timed against a different release. Report it with the song link.
If every song is off on your device, use the playback-offset setting in Spicy Lyrics.
Install the font on your computer, then:
Open Marketplace → Snippets → Add CSS.
Paste this, replacing Your Font Name with the font's exact name:
* {
font-family: "Your Font Name" !important;
}
Name and save the snippet.
In Spicy Lyrics settings, enable Use System Font under Appearance.
This changes Spotify's whole interface font, not only the lyrics. Disable the snippet if characters go missing or layouts break.
Search #extension-suggestions first, then post if your idea isn't already there. Describe the problem and who it affects, not only the solution you want.
More answers are in the full FAQ.
Most word-synced lyrics in Spicy Lyrics are TTML files made by the community. TTML is an XML-based format that can store line and word timing, background vocals, duet positioning, and romanization, which LRC can't do consistently.
To make one, start with the TTML Guide:
Line-synced TTML is fully valid. If it's your first file, start with whole-word timing and learn syllable splitting later.
| Guide | Covers |
|---|---|
| Transcription Guide | Spelling, capitalization, punctuation, ad-libs, censored lyrics, repeats, and romanization |
| Splitting Guide | Splitting words into timed syllables, and which splits are accepted |
| Uploading and TTML Rules | What an upload must meet to be approved |
| Separating Vocals | Isolating vocals so words are easier to hear while syncing |
| TTML Tool Feature Reference | Every feature of the TTML Tool |
The short version of the rules:
[Instrumental], section headings, ellipses, or placeholders. Spicy Lyrics draws interludes itself.Requires Bun and a working Spicetify install.
bun install
bun run dev
bun run build
bun run lint
bun run fmt
The extension is licensed under AGPL-3.0. The hosted services, databases, and websites behind Spicy Lyrics are separate and aren't covered by this license.
Inspired by Beautiful Lyrics
Spicy Lyrics is an Extension made for Spicetify - A Spotify Client modifier
See the code
Spicy Lyrics replaces Spotify's lyrics view with animated lyrics, dynamic backgrounds, romanization, and customization options. It is an open-source extension for the Spotify desktop client, built on Spicetify.
Links: Guides · FAQ · Status · Discord · Developers Platform
Spicy Lyrics runs only in the Spotify desktop client, through Spicetify. It does not need Spotify Premium.
Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
macOS / Linux (Terminal):
curl -fsSL https://raw.githubusercontent.com/spicetify/cli/main/install.sh | sh
[!WARNING] Spicetify cannot modify a Snap-based Spotify installation on Linux. See the official Spicetify guide for other setups.
Look for the Marketplace button in Spotify's top-left corner. If it's missing, install it:
Windows:
iwr -useb https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.ps1 | iex
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.sh | sh
Play a song and open the lyrics view to confirm it loaded. Marketplace installs update automatically; restart Spotify if a new version hasn't appeared.
spicy-lyrics.mjs.spicetify config extensions spicy-lyrics.mjs
spicetify apply
Manual installs don't update automatically.
If Spicy Lyrics disappears after a Spotify update or fails to load, try these in order:
spicetify apply
spicetify backup apply
spicetify update
spicetify restore backup apply
Lyrics missing, outdated, or wrong?
High CPU or memory use? Animated lyrics, dynamic backgrounds, themes, custom CSS, and other extensions all add load. Restart Spotify, test without other extensions or snippets, and check Spotify's hardware-acceleration setting.
Search #extension-bugs first. If it's new, include:
[!CAUTION] Never share account tokens, cookies, authorization headers, or other secrets in a bug report.
Security issues go through SECURITY.md, not public channels.
| Type | What it does |
|---|---|
| Word-synced | Highlights individual words, or timed parts of words, as they're sung. |
| Line-synced | Advances one timed line at a time. |
| Static | Shows lyrics without timing. |
The sync type depends on the lyric data available for that exact track. There's no setting to turn line-synced lyrics into word-synced ones.
Community-uploaded TTML lyrics first, then other supported sources, including Apple Music and Spotify. What you see depends on availability, matching, and source priority.
No. The extension runs in Spotify's desktop client only.
Spicy Player is a separate offline Android music player by TX24 that ports the Spicy Lyrics experience. It is not a Spotify mobile extension.
Online lyric lookup needs an internet connection. Lyrics you import into the Lyrics Manager's persistent local library stay on your device until you remove them.
Yes. Open the Lyrics Manager and import the TTML as a temporary upload (for quick testing) or a persistent one (kept in your local library). There's no setting for adding other online lyric providers.
If one song is off, the lyric file may have been timed against a different release. Report it with the song link.
If every song is off on your device, use the playback-offset setting in Spicy Lyrics.
Install the font on your computer, then:
Open Marketplace → Snippets → Add CSS.
Paste this, replacing Your Font Name with the font's exact name:
* {
font-family: "Your Font Name" !important;
}
Name and save the snippet.
In Spicy Lyrics settings, enable Use System Font under Appearance.
This changes Spotify's whole interface font, not only the lyrics. Disable the snippet if characters go missing or layouts break.
Search #extension-suggestions first, then post if your idea isn't already there. Describe the problem and who it affects, not only the solution you want.
More answers are in the full FAQ.
Most word-synced lyrics in Spicy Lyrics are TTML files made by the community. TTML is an XML-based format that can store line and word timing, background vocals, duet positioning, and romanization, which LRC can't do consistently.
To make one, start with the TTML Guide:
Line-synced TTML is fully valid. If it's your first file, start with whole-word timing and learn syllable splitting later.
| Guide | Covers |
|---|---|
| Transcription Guide | Spelling, capitalization, punctuation, ad-libs, censored lyrics, repeats, and romanization |
| Splitting Guide | Splitting words into timed syllables, and which splits are accepted |
| Uploading and TTML Rules | What an upload must meet to be approved |
| Separating Vocals | Isolating vocals so words are easier to hear while syncing |
| TTML Tool Feature Reference | Every feature of the TTML Tool |
The short version of the rules:
[Instrumental], section headings, ellipses, or placeholders. Spicy Lyrics draws interludes itself.Requires Bun and a working Spicetify install.
bun install
bun run dev
bun run build
bun run lint
bun run fmt
The extension is licensed under AGPL-3.0. The hosted services, databases, and websites behind Spicy Lyrics are separate and aren't covered by this license.
Inspired by Beautiful Lyrics