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