spicetify/cli

Analysis updated 2026-06-21

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

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

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

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

GoJavaScriptCSS

How does it compare?

	spicetify/cli	node-red/node-red	benweet/stackedit
Stars	23,022	23,090	22,932
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	moderate	easy	moderate
Complexity	2/5	2/5	2/5
Audience	developer	general	writer

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

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

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub spicetify on gitmyhub

Verify against the repo before relying on details.