A Spicetify theme inspired by spotify-tui, styled after a terminal interface: panel border labels ("Nav", "Library", "Main", "Sidebar", "Playing"), Nerd Font monospace typography, an ASCII art banner on the home page, ASCII page titles, and text-glyph playback controls instead of SVG icons. The window frame itself is reworked too — thinner borders and no minimize/maximize/close buttons, for a clean, borderless look that fits tiling window managers like komorebi.
Originally based on the community text theme from the official spicetify-themes repo, heavily reworked since (progress bar, volume bar, layout, window frame, and compatibility fixes for recent Spotify updates).
Besides the theme, the repo ships a few small Spicetify extensions: one that removes the native window buttons, one that cleans up backgrounds and cover art, and draggable animated GIF characters (Sonic, Tails, Shadow, Miku, Tanjiro...) that you can move around, resize, or switch off.
Developed and tested on Windows 11 with Spotify 1.3.6 and Spicetify 2.46.4 (October 2026). Spotify updates regularly rename its internal CSS classes and change its page structure, so if something looks off after an update, see After a Spotify update.
- Preview
- Requirements
- What's in this repo
- Installation
- The extensions
- The animated characters
- Customizing
- About the window frame
- After a Spotify update
- Changing the palette or theme
- Troubleshooting
- Credits and copyright
- License
- Spicetify installed and working (2.46.4 tested)
- Spotify desktop installed with the official installer — Spicetify does not support the Microsoft Store version
- The 0xProto Nerd Font Mono font installed on your system — required for the ASCII banner alignment and the control glyphs
- An internet connection when Spotify starts:
user.cssloads theasciidfont (used for the ASCII page titles) fromfonts.cdnfonts.com, and optional Google Fonts monospace alternatives
| File | What it is | Where it goes |
|---|---|---|
user.css |
The theme's styles | Themes/TUI/ |
color.ini |
The color palettes | Themes/TUI/ |
noControls.js |
Extension that removes the native window controls (details) | Extensions/ |
flatBackgrounds.js |
Extension that flattens backgrounds and hides header cover art (details) | Extensions/ |
draggablePets.js |
Extension that adds the draggable animated characters (details) | Extensions/ |
Both folders live in your Spicetify config directory: %appdata%\spicetify\ on Windows, ~/.config/spicetify/ on Linux/macOS. spicetify -c prints the path of the config-xpui.ini file, which sits in that same directory.
Which extensions do you need?
| Extension | Needed? |
|---|---|
noControls.js |
Recommended — the theme is designed for a window without native buttons |
flatBackgrounds.js |
Recommended — without it, header cover art can stay visible and colored gradients can come back on some pages |
draggablePets.js |
Optional — purely decorative (and the heaviest file, about 670 KB, because the GIFs are embedded in it) |
-
Install the 0xProto Nerd Font Mono font (link above) if you haven't already.
-
Download
user.css,color.iniand the extensions you want (noControls.js,flatBackgrounds.js,draggablePets.js) from this repo. -
Copy them into your Spicetify config directory. From the folder containing the downloaded files, in PowerShell:
$cfg = spicetify -c | Split-Path New-Item -ItemType Directory -Force "$cfg\Themes\TUI", "$cfg\Extensions" | Out-Null Copy-Item .\user.css, .\color.ini "$cfg\Themes\TUI\" Copy-Item .\noControls.js, .\flatBackgrounds.js, .\draggablePets.js "$cfg\Extensions\"
Or by hand:
user.cssandcolor.inigo in a newThemes/TUI/folder, the.jsfiles go inExtensions/. Leave out the extensions you don't want. -
Enable the theme and the extensions:
spicetify config current_theme TUI spicetify config color_scheme TokyoNight spicetify config inject_css 1 replace_colors 1 overwrite_assets 1 spicetify config extensions noControls.js spicetify config extensions flatBackgrounds.js spicetify config extensions draggablePets.jsEach
spicetify config extensions <file>adds the extension to your list, it doesn't replace the extensions you already use. Skip the lines of the extensions you didn't copy.Want another palette than
TokyoNight? See Changing the palette or theme. -
Apply:
spicetify applyIf Spicetify complains about a missing backup (first use, or right after reinstalling Spotify), run
spicetify backup applyinstead. -
Check with
spicetify configthatcurrent_themeisTUI, and withspicetify config extensionsthat the list contains the extensions you enabled.
Scoop users — keep the files in the config directory above, not in
scoop\apps\spicetify-cli\<version>\Themes: that folder is specific to one Spicetify version and isn't carried over when Scoop installs the next one. If Spicetify reports an extension as not found after an update, also copy it toscoop\apps\spicetify-cli\<version>\Extensions(this fixed it in testing withnoControls.js).
The extensions are plain JavaScript files that Spicetify runs inside Spotify. They are short and commented (apart from the GIF data embedded in draggablePets.js), so you can read them before installing. To disable one, run spicetify config extensions <file>- (note the trailing -) and spicetify apply.
The theme is designed for a window without native minimize/maximize/close buttons. noControls.js is the small extension that removes them (it comes from the Spicetify community; see Credits), and user.css handles the layout side: it sets --global-nav-margin-top to 0px and collapses the space Spotify reserves for those buttons at the top right of the window (the rules commented "space reserved for the window buttons / controls" in user.css).
Because that space is gone, the native buttons may overlap the top-right icons if the extension isn't loaded. Either install the extension (steps 3 and 4 above) or follow Getting the native buttons back.
Spotify can bring its title bar back after startup (window focus, restore from minimize, resize, wake from sleep), which shows the native buttons as thin white marks above the app. In this repo noControls.js hides them again on those events, and every 5 seconds as a safety net, instead of only during the first 10 seconds. A brief flash of the native buttons while Spotify starts or reloads (F5) is normal: the extension can only act once Spotify's APIs are available, and the CSS can't hide them because they are not part of the page.
Spotify paints its pages with color tints and gradients that depend on the album art, and it renames the CSS classes that carry them with every update. This extension does that work in a way that doesn't depend on class names:
- it removes tints and gradients from the main panel (
#main-view): sticky bars and headers get the plain theme color, everything else becomes transparent; - when
--display-header-imageisnone(the default), it hides the large cover art at the top of playlist, album and artist pages, detecting the image by its size and position instead of by class names; - it tags the artist name on artist pages so that
user.csscan style it with the ASCII title font.
It only looks at #main-view, reacts to page changes as they happen (so there is no flash), and leaves buttons, inputs, rows and menus alone.
Adds the animated characters described below. The file is about 670 KB because the GIFs are embedded in it as base64; the logic itself is around 360 lines.
Earlier versions of this repo shipped marketplaceTabs.js, a workaround for the Marketplace custom app losing its tab bar (Extensions / Themes / Snippets / Apps) on Spotify 1.3.3 and later (upstream issues #1253 and #1265). With an up-to-date Marketplace the tabs display correctly without it (tested with Spotify 1.3.6), so the extension was removed from the repo.
- If you installed it from an earlier version of this theme, disable it:
spicetify config extensions marketplaceTabs.js-, thenspicetify apply. - If the Marketplace tabs are missing, update the Marketplace by running its install script again (see the Marketplace installation guide). When it asks whether to replace your local theme with a placeholder, answer N to keep TUI.
- On an old Marketplace that can't be updated, the file is still available in this repository's Git history.
user.css still tidies the Marketplace grid (3 columns, smaller card text, a discreet "Add CSS" button).
draggablePets.js adds animated GIF characters to the interface. They are real elements floating above Spotify, so you can drag them anywhere, resize them, and hide them.
- Move: click a character and drag it anywhere in the window. Its position is remembered (as a proportion of the window size).
- Back to the default position: double-click the character (only that character's position; its size is left as it is).
- Settings panel: right-click a character, or press Ctrl+Alt+P (the extension also tries to add an entry to Spicetify's profile menu, which depends on your Spotify version). The panel lets you:
- show or hide each character with its checkbox;
- resize them with the sliders ("Sprites" = Shadow, Tails and Sonic together; then one slider each for Cat, Miku, Tanjiro and Ambers), from 50% to 200%;
- Reset positions & sizes to restore every default position and every default size (100%); hidden characters stay hidden;
- Hide / show all at once.
- From the console (DevTools, see After a Spotify update):
tuiPets.panel()opens the panel,tuiPets.toggle("cat")hides or shows one character (ids:shadow,tails,sonic,cat,miku,tanjiro,ambers),tuiPets.reset()does the same as Reset positions & sizes (default positions and sizes),tuiPets.setMargin(n)changes how far Sonic and Tails sit from the right end of the progress bar (default0, negative values push them further right).
Settings are stored in Spotify's local storage under the key tui-pets-v1.
| Character | Default position | Shown on |
|---|---|---|
| Shadow | Start of the progress bar, standing on it | every page |
| Tails, Sonic | Right end of the progress bar | every page |
| Tanjiro | Search bar, left of the vertical separator | every page |
| Cat | Home page, top of the main panel, to the right of the filter chips | home page only |
| Miku | Home page, sitting on the top edge of the top-right shortcut tile | home page only |
| Ambers | Home page, top-right corner of the Main frame | home page only |
Default positions are computed from elements of the page (progress bar, search bar, shortcut tiles...), so they follow window resizing. If a Spotify update moves those elements and a character lands in the wrong place, drag it where you want it, or adjust the formulas in the defaultPos function of draggablePets.js.
Keep in mind that the characters sit above the interface and capture the mouse while you hover them: if one covers a button you need, drag it away or hide it.
- Temporarily: Hide / show all in the panel (or
tuiPets.toggle(...)per character). - Completely:
spicetify config extensions draggablePets.js-, thenspicetify apply. You can also delete the file from yourExtensions/folder.
user.css no longer draws any character itself, so there is nothing else to remove.
The options at the top of user.css (:root block) can be changed freely, then run spicetify apply:
| Variable | Effect |
|---|---|
--font-family |
Main font (default 0xProto Nerd Font Mono); other monospace fonts are listed in a comment |
--display-card-image |
block / none: cover art on cards |
--display-coverart-image |
block / none: cover art in the playback bar |
--display-header-image |
block / none: large cover art at the top of playlist/album/artist pages (default none, hidden by flatBackgrounds.js) |
--display-sidebar-image |
block / none: cover art in the right sidebar |
--display-tracklist-image |
block / none: thumbnails in track lists (default none) |
--display-spicetify-banner-ascii |
block / none: the ASCII banner on the home page |
--banner-ascii-height |
Space reserved for that banner: set it to 0px if you hide the banner |
--tui-header-height |
Minimum height of playlist/album/artist page headers (near the end of the file) |
--border-radius, --border-width |
Shape and thickness of the panel borders |
Chip size (zoom on [data-encore-id="chip"]) and the Marketplace grid (minmax(150px, 1fr)) are set in the last blocks of the file.
This theme removes the native minimize/maximize/close buttons and slims down the window borders, matching the borderless look tiling window managers usually go for. Keep in mind what that changes in practice:
- Closing/minimizing the app now depends entirely on your window manager's keybinds (or the system tray icon / taskbar) — there's no button left to click.
- If you're not running a tiling WM (komorebi, GlazeWM, i3, etc.), test this on a machine where you can still reach the app another way before committing to it daily — Alt+F4 still works, but it's easy to feel "stuck" the first time.
You can keep the rest of the theme and restore the buttons:
- Remove the extension from your config:
spicetify config extensions noControls.js- - In
user.css, raise--global-nav-margin-top(for example to32px) until the top bar sits below the native buttons. - Delete or comment out the three rules commented "space reserved for the window controls" / "space reserved for the window buttons" (search for
space reserved for the windowinuser.css). - Run
spicetify apply.
Spotify updates can overwrite Spicetify's changes, rename the classes the theme relies on, or change the structure of the page. The current version of the theme leans on stable hooks (element ids, data-testid, aria-label, roles) and on the extensions, but a few rules still target generated class names.
- Re-apply Spicetify:
spicetify backup apply. - If Spicetify says the Spotify version and the backup version are mismatched and refuses to back up: reinstall Spotify with the official installer, launch it once, close it, then run
spicetify backup apply(notrestore, there is nothing left to restore). - Scoop users: update Spicetify with
scoop update spicetify-cli. The built-inspicetify updatecan fail on a Scoop install. - If a colored gradient or tint comes back (top of the home page, top of a playlist page...), the rules that neutralize them need the new class names Spotify generated. They look like
[class*="dqwQh"]and are grouped in the blocks commented "Spotify 1.3.x" near the end ofuser.css. - If the ASCII banner disappears, check the rule just below the "MAIN VIEW" comment: it relies on
[data-testid="home-page"]. - If panel frames, the ASCII banner or the playback bar look doubled or misplaced, Spotify has probably brought back class names that were gone for a while. The older class-based rules and the newer ones (ids,
data-testid) then match at the same time. The block commented "Anti-doublons" at the end ofuser.cssneutralizes the old rules; use DevTools (below) to see which elements carry the frame or the banner and extend that block if needed.
To find new class names, enable DevTools: spicetify config always_enable_devtools 1, then spicetify apply, restart Spotify and press Ctrl+Shift+I (or right-click → Inspect element). Select the colored area, copy a few characters of its class name, and update the matching rule. Copy rather than retype: in the DevTools font, I/l and 0/O look alike. Then run spicetify apply again.
Also worth checking after an update: whether the Marketplace tabs still display (see marketplaceTabs.js (removed) if they don't).
If something else breaks, open an issue with a screenshot and your Spotify and Spicetify versions (spicetify -v).
All the colors live in color.ini, one palette per [Section]. The value you give to color_scheme must match a section name exactly — same capitalization, no spaces, no accents (RosePine, not Rosé Pine; CatppuccinMocha, not Catppuccin).
- Pick a name from the list below, or list them straight from your install:
Select-String -Path "$(spicetify -c | Split-Path)\Themes\TUI\color.ini" -Pattern '^\[(.+)\]' | ForEach-Object { $_.Matches[0].Groups[1].Value }
- Set it and apply (example with Dracula):
spicetify config color_scheme Dracula spicetify apply - Check with
spicetify configthatcurrent_themeisTUI,color_schemeis the palette you chose, and thatinject_cssandreplace_colorsare both1.
Available palettes: TokyoNight (default in this guide), TokyoNightStorm, CatppuccinMocha, CatppuccinMacchiato, CatppuccinLatte, Dracula, Gruvbox, Kanagawa, Nord, Rigel, RosePine, RosePineMoon, RosePineDawn, Solarized, EverforestDarkMedium, ForestGreen, Spotify, Spicetify.
Nothing changed after spicetify apply?
- The name doesn't match a section of
color.iniexactly (see the note above). replace_colorsis0: runspicetify config replace_colors 1 inject_css 1, thenspicetify apply.- You edited
color.iniin a downloaded copy of the repo instead of the one Spicetify reads: it must be in%appdata%\spicetify\Themes\TUI\(spicetify -c | Split-Pathprints the config folder). - Spotify didn't reload: close it completely (system tray included), reopen it, or run
spicetify applyagain.
Copy an existing block of color.ini, rename the [Section], and change the values (hex colors, without the #):
[MyPalette]
accent = ff79c6
accent-active = ff79c6
accent-inactive = 1e1e2e
banner = ff79c6
border-active = ff79c6
border-inactive = 313244
header = 585b70
highlight = 585b70
main = 1e1e2e
notification = 89b4fa
notification-error = f38ba8
subtext = a6adc8
text = cdd6f4Then spicetify config color_scheme MyPalette and spicetify apply. All 13 keys must be present. Roughly: main is the background, text/subtext the text colors, and accent the highlight color.
spicetify config current_theme <ThemeFolderName>
spicetify config color_scheme <a palette from that theme's color.ini>
spicetify config extensions noControls.js-
spicetify config extensions flatBackgrounds.js-
spicetify apply
The third line matters: noControls.js hides the native window buttons, and other themes don't make room for them — see Getting the native buttons back. flatBackgrounds.js is written for this theme and would also flatten another theme's backgrounds, so remove it too. draggablePets.js doesn't depend on the theme and can stay. To remove Spicetify's changes entirely, run spicetify restore (and spicetify backup apply to bring them back).
- No character shows up: check that
spicetify config extensionslistsdraggablePets.js, then runspicetify applyand restart Spotify. Cat, Miku and Ambers only appear on the home page. Press Ctrl+Alt+P to open the panel and check the boxes; Hide / show all may have hidden everything. - Characters appear twice: you are mixing an older version of
user.css(which drew some characters in CSS) with the current extension. Use theuser.cssof this repo. - A character is stuck in the wrong place: double-click it, or use Reset positions & sizes in the panel.
- A character covers a button: drag it away; characters capture the mouse while you hover them.
- Marketplace tabs are missing: update the Marketplace by running its install script again (see
marketplaceTabs.js(removed)). - Thin white marks appear above the app window: they are the native window buttons coming back. Make sure
noControls.jsis enabled and is the version from this repo (it re-applies the hiding on focus, resize and restore); a brief flash while Spotify loads is normal. - Frames, banner or playback bar look doubled after an update: see point 6 of After a Spotify update.
- Header cover art or colored gradients are back on playlist pages:
flatBackgrounds.jsis not enabled, or a Spotify update changed a class name (see After a Spotify update). - The console shows warnings: DevTools may list warnings about preloaded fonts, failed
sentry.iorequests (if you block telemetry) and repeatedResolver not founderrors coming fromnoControls.jswith recent Spotify versions. They don't affect the theme.
- Base
texttheme: spicetify/spicetify-themes - Inspiration: Rigellute/spotify-tui
noControls.js: by OhItsTom and Podpah (a Spicetify community extension), included here for convenience and modified to re-apply the title bar hiding- Sonic on the progress bar: the idea comes from the "Sonic Dancing" snippet by @uhAlexz, via spicetify/marketplace. In this repo the characters are drawn by
draggablePets.js, so you don't need to install that snippet.
About the animated GIFs. The characters belong to their respective owners and creators: Sonic, Tails and Shadow (SEGA), Hatsune Miku (Crypton Future Media), Tanjiro (Demon Slayer), and the other illustrations (the cat, Ambers) come from their own authors. The GIFs were taken from third-party sources, are shipped here only as small decorative assets, and are not covered by this repository's license. The three pixel-art characters were reduced losslessly to their native size and the other GIFs were downscaled to keep the extension light. If you are a rights holder and want a GIF removed, or if you know the author of one of them and want it credited, please open an issue.
MIT for the code of this repo — same license as the base text theme from spicetify/spicetify-themes, which this theme is derived from. The animated GIFs embedded in draggablePets.js are excluded, see Credits and copyright.

