gitwtfhub

wtf is cli?

spicetify/cli — explained in plain English

Analysis updated 2026-06-21

★ 23,022JavaScriptAudience · developerComplexity · 2/5Setup · moderate

TL;DR

A command-line tool that unlocks Spotify's desktop app for customization, letting you apply color themes, inject CSS, and add extensions that Spotify doesn't officially support.

Mindmap

mindmap
  root((repo))
    What it does
      Modifies Spotify client
      Injects custom code
      Applies themes
      Adds extensions
    Tech stack
      Go
      JavaScript
      CSS
    Use cases
      Custom color themes
      Lyrics display
      Keyboard shortcuts
      Sidebar apps
    Audience
      Power users
      JS developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Apply a custom dark theme to your Spotify desktop app to match your system's color scheme

REASON 2

Add a lyrics display extension that shows song lyrics inside Spotify while music plays

REASON 3

Create custom keyboard shortcuts for playback controls in Spotify using a Spicetify extension

REASON 4

Install a custom sidebar app in Spotify that adds features the official client doesn't include

What's in the stack?

GoJavaScriptCSS

How it stacks up

spicetify/clinode-red/node-redbenweet/stackedit
Stars23,02223,09022,932
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencedevelopergeneralwriter

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Spotify desktop app, Spotify updates can break customizations and need Spicetify to be re-applied.

Wtf does this do

Spicetify is a command-line tool that lets you customize the official Spotify desktop app. By default Spotify's appearance and features are locked, you cannot change colors, add new features, or adjust the interface. Spicetify unlocks those restrictions. It works by modifying Spotify's client files and injecting custom code. You can change the color scheme of the entire interface, apply custom CSS to alter the look of any element, add Extensions (small scripts that add new features like lyrics display, keyboard shortcuts, or playback controls), and install custom built-in apps that appear in Spotify's sidebar. You would use this if you find the default Spotify interface boring or limiting and want to personalize it, for example, applying a dark theme, adding missing features, or extending playback controls. It works on Windows, macOS, and Linux. The tool is written in Go but extensions and themes are written in JavaScript and CSS. It requires some comfort running commands in a terminal to install and use.

Yoink these prompts

Prompt 1
How do I install Spicetify on macOS and apply a custom dark theme to the Spotify desktop app?
Prompt 2
Write me a Spicetify extension in JavaScript that shows the current song's BPM in the Spotify player bar.
Prompt 3
I want to add keyboard shortcuts to control Spotify playback using Spicetify, how do I write that as an extension?
Prompt 4
How do I create and publish a custom Spicetify theme with a specific color palette?
Prompt 5
My Spotify updated and broke Spicetify, how do I restore my customizations after an update?

Frequently asked questions

wtf is cli?

A command-line tool that unlocks Spotify's desktop app for customization, letting you apply color themes, inject CSS, and add extensions that Spotify doesn't officially support.

What language is cli written in?

Mainly JavaScript. The stack also includes Go, JavaScript, CSS.

How hard is cli to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cli for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane