DOCUMENTATION

Navify

Customize Spotify desktop with themes, extensions, apps, snippets, and a built-in Marketplace.

Navify modifies the installed Spotify desktop client. It does not create a separate Spotify application.

Install Navify Set up the CLI and Marketplace Add a theme Install and apply visual styles Build a project Create apps and extensions

Requirements

Spotify desktop installed from spotify.com
Spotify opened and signed in at least once
An internet connection for installation and Marketplace listings
PowerShell on Windows or a terminal on macOS and Linux

Installation

Close Spotify completely.
Download the latest Navify release.
Run install.bat.
Open Spotify after installation completes.

If PowerShell blocks an npm command, run its .cmd version, such as create-navify-app.cmd.

Close Spotify completely.
Open Terminal in the Navify folder.
Run chmod +x install.sh.
Run ./install.sh and reopen Spotify.

Close Spotify completely.
Open a terminal in the Navify folder.
Run chmod +x install.sh.
Run ./install.sh and reopen Spotify.

Marketplace

Marketplace becomes available inside Spotify after Navify is installed and applied. Catalog items are never installed automatically.

Open Marketplace from the Spotify sidebar.
Choose Extensions, Themes, Snippets, or Apps.
Select an item and press Install.
Use Reload now when prompted.

Items without preview artwork display "No image." Marketplace itself does not appear as an installed item.

Themes

The default theme is normal Spotify. A custom theme is active only after it is installed and selected.

Windows %APPDATA%\navify\Themes

macOS ~/.config/navify/Themes

Linux ~/.config/navify/Themes

Each theme belongs in its own folder and should contain user.css and color.ini.

navify config current_theme ThemeName
navify config color_scheme SchemeName
navify apply

Extensions

Install an extension from Marketplace or place a compatible JavaScript file in the Navify Extensions folder.

navify config extensions example.js
navify apply

Apps

Custom apps add complete pages to Spotify. Install from Marketplace or place an app folder in the Navify CustomApps directory.

navify config custom_apps example
navify apply

Navify Creator

Navify Creator scaffolds and builds custom apps and extensions.

create-navify-app.cmd
create-navify-extension.cmd

On macOS and Linux, omit .cmd. Run build.bat on Windows to build all creator packages.

CLI commands

navify apply Apply the current configuration

navify backup apply Create a backup and apply Navify

navify restore Restore the original Spotify files

navify config Read or change configuration values

navify update Update Navify

navify -v Show the installed version

Troubleshooting

Marketplace is missing

Close Spotify, run marketplace.bat, choose Enable, and reopen Spotify after Navify applies.

A theme does not appear

Confirm it has its own folder containing user.css and color.ini, then reload Marketplace.

Spotify opens to a blank page

Run navify restore, update Spotify, open it once, close it, and install Navify again.

Changes load slowly

Disable unused apps, extensions, and animated themes, then apply Navify again.

Uninstall

Close Spotify and run uninstall navify.bat on Windows. Use navify restore first on any supported platform.

Privacy Policy

Navify does not collect, sell, or share your personal information.

All themes, extensions, apps, and configuration files are stored locally on your device. Navify only connects to the internet when downloading updates, Marketplace listings, or content that you explicitly choose to install.

Navify does not access your Spotify account credentials, passwords, payment information, or private Spotify data. Authentication is handled entirely by Spotify.

Marketplace downloads occur only after you choose to install an item. No themes, extensions, apps, or snippets are installed automatically.

Third-party Marketplace content may have its own privacy practices. Review the documentation provided by its creator before installing.

By using Navify, you acknowledge that it modifies the installed Spotify desktop client. You can restore the original Spotify installation at any time by running navify restore.