❯ SPICETIFIX

Automated Spotify & Spicetify Setup, Extension Manager & Terminal Control Center for Windows.

Spicetifix is a minimal, terminal-styled desktop application for installing, configuring, and managing Spotify and Spicetify on Windows. It uses a pywebview native window (WebView2) wrapping a Python sidecar API backend served on 127.0.0.1.

---

⚡ Features

• Native Desktop Window — Runs in a pywebview window (WebView2), no browser dependency.
• Automated Setup — Installs Spotify, Spicetify CLI, themes, Marketplace, and configures everything in one click.
• Native Marketplace Tab — Browse, search, and 1-click install/uninstall extensions (e.g. Adblock, Popup Lyrics, Full App Display, Loopy Loop, Bookmark, Auto Skip Explicit) and themes directly as persistent local files (.js).
• Persistent Extension Management — Automatically downloads .js files to Extensions/ and registers them in config-xpui.ini & spicetifix.yaml, ensuring 100% reboot/cache survival and full ZIP backup compatibility.
• Extension Manager — Auto-detects installed .js/.mjs extensions with live toggles.
• Live Spotify Widget — Now Playing display with Prev / Play-Pause / Next controls.
• 14 UI Themes — Cyber Emerald, Dracula, Amber CRT, Nordic Frost, Matrix Void, Tokyo Night, Catppuccin Mocha, and more.
• System Recovery — One-click spicetify restore backup apply after Spotify updates.
• Health Diagnostics — Real-time checklist verifying all system paths.
• Backup & Restore — Export/import full Spicetify configuration as .zip.
• Multilingual — English & Spanish.

---

🚀 Quick Start

Option 1: Run from Source

git clone https://github.com/RAlexander777/Spicetifix.git
cd Spicetifix
python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
python main.py

Running python main.py opens a native pywebview window (WebView2). If the WebView2 runtime is missing, it falls back to a browser window (--app mode). You can also visit http://127.0.0.1:8765 directly in any browser.

Option 2: Download Portable EXE

Download the latest Spicetifix.zip from Releases, extract, and run Spicetifix.exe.

---

🧪 Running Tests

python -m unittest discover -s tests

---

📦 Building Executable

.\venv\Scripts\activate
pip install pyinstaller
python scripts/build_exe.py

Output: dist/Spicetifix/ (onedir) + dist/Spicetifix.zip (compressed archive).

---

🛠 Project Structure

spicetifix/
├── spicetifix/
│   ├── api.py                 # Python HTTP API server (sidecar, token auth)
│   ├── core/
│   │   ├── config.py          # Spicetify INI & YAML config handling
│   │   ├── i18n.py            # English / Spanish strings
│   │   ├── installer.py       # Installation & recovery engine
│   │   ├── marketplace_fetcher.py # Spicetify Marketplace catalog fetcher
│   │   ├── spotify_control.py # Windows Win32 Spotify controls
│   │   ├── themer.py          # Spicetify theme manager
│   │   ├── ui_theme.py        # UI theme palettes
│   │   ├── updater.py         # GitHub release check & ZIP download
│   │   └── utils.py           # Helpers
├── web/
│   ├── index.html             # Main UI (loaded in pywebview window)
│   ├── app.js                 # Frontend logic
│   ├── style.css              # Terminal-styled CSS
│   └── i18n/
│       ├── es.json            # Spanish translations
│       └── en.json            # English translations
├── scripts/
│   └── build_exe.py           # PyInstaller build script
├── docs/
│   └── DESKTOP_APPS_GUIDE.md  # Reusable desktop-app development guide
├── tests/                     # Unit tests
├── main.py                    # Entry point (pywebview window + API server)
├── pyproject.toml             # Python packaging metadata
├── requirements.txt           # Python dependencies
└── LICENSE                    # MIT License

---

📄 License

Distributed under the MIT License. See LICENSE for details.

Author: RAlexander777 · Copyright (c) 2026 RAlexander777

If you use, fork, or build on this project, keep the copyright notice and credit the author.