Skip to main content

Commands

This page documents all Spicetify CLI commands.

Core Commands​

spicetify (no arguments)​

Run with no arguments to generate the config file on first run, or verify your setup.

spicetify

backup​

Create a backup of vanilla Spotify files. Required before applying Spicetify for the first time.

spicetify backup

apply​

Apply Spicetify modifications to Spotify.

spicetify apply

This injects your theme, extensions, custom apps, and other modifications into Spotify.

restore​

Remove all Spicetify modifications and restore Spotify to vanilla state.

spicetify restore

Your config file and customization files are preserved.

update​

Hot-reload theme changes without full restart. Use this during theme development.

spicetify update

After running, press Ctrl + Shift + R (or Cmd + Shift + R on macOS) in Spotify to see changes.

upgrade​

Upgrade Spicetify to the latest version (only works with script-based installations).

spicetify upgrade

Configuration Commands​

config​

View or modify configuration values.

View all settings:

spicetify config

View a specific setting:

spicetify config current_theme

Set a value:

spicetify config current_theme Sleek

Set multiple values:

spicetify config current_theme Sleek color_scheme Dark

Add to a list (extensions, custom_apps):

spicetify config extensions fullAppDisplay.js

This appends to existing extensions, not replaces.

Remove from a list:

spicetify config extensions fullAppDisplay.js-

Note the trailing -.

config-dir​

Open the Spicetify config directory in your file manager.

spicetify config-dir

-c / --config​

Print the config file path.

spicetify -c

Utility Commands​

enable-devtools​

Enable Chromium DevTools in Spotify. Useful for debugging themes and extensions.

spicetify enable-devtools

Access DevTools with Ctrl + Shift + I.

watch​

Watch for theme changes and auto-apply. Useful during development.

spicetify watch

Monitors color.ini and user.css in your current theme folder.

path​

Print various Spicetify-related paths.

spicetify path
spicetify path userdata   # Config directory
spicetify path spotify    # Spotify installation

auto​

Automatically backup (if needed) and apply, then launch Spotify.

spicetify auto

Useful as a shortcut target instead of the Spotify executable.

Combined Commands​

Commands can be combined in a single call:

# First-time setup
spicetify backup apply enable-devtools

# After Spotify updates
spicetify backup apply

# Full restore and reapply
spicetify restore backup apply

Flags​

--help / -h​

Show help for a command.

spicetify --help
spicetify --help config

--version / -v​

Show Spicetify version.

spicetify --version

--no-restart​

Apply changes without restarting Spotify.

spicetify apply --no-restart

--quiet / -q​

Suppress non-error output.

spicetify apply -q

--extension / -e​

Specify a single extension to apply (useful for testing).

spicetify apply -e myExtension.js

Examples​

Fresh Install Workflow​

# Install Spicetify (see Installation page)
# Generate config
spicetify

# First-time setup
spicetify backup apply enable-devtools

Enable an Extension​

spicetify config extensions fullAppDisplay.js
spicetify apply

Change Theme​

spicetify config current_theme Sleek color_scheme Dark
spicetify apply

After Spotify Updates​

spicetify backup apply

Theme Development​

# One-time: apply your theme
spicetify config current_theme MyTheme
spicetify apply

# During development: watch for changes
spicetify watch