https://github.com/darksaces/spotify-toolkit
A powerful Spotify management toolkit built with Python and CustomTkinter. Automate your music library with a modern GUI.
https://github.com/darksaces/spotify-toolkit
automation customtkinter desktop-application gui music-management open-source open-source-project open-sources-code-github productivity productivity-tools python spotify spotify-api spotipy spotipy-library toolkit tools
Last synced: 1 day ago
JSON representation
A powerful Spotify management toolkit built with Python and CustomTkinter. Automate your music library with a modern GUI.
- Host: GitHub
- URL: https://github.com/darksaces/spotify-toolkit
- Owner: DarksAces
- License: mit
- Created: 2026-03-12T21:40:46.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-26T10:06:27.000Z (1 day ago)
- Last Synced: 2026-04-26T11:24:28.639Z (1 day ago)
- Topics: automation, customtkinter, desktop-application, gui, music-management, open-source, open-source-project, open-sources-code-github, productivity, productivity-tools, python, spotify, spotify-api, spotipy, spotipy-library, toolkit, tools
- Language: Python
- Homepage:
- Size: 125 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎵 Spotify Toolkit
A powerful, all-in-one GUI suite designed to manage, clean, and optimize your Spotify library with ease. Leverage the full power of the Spotify API through a friendly and intuitive interface.
---
## 🇺🇸 English Version
### 🚀 Quick Start (Plug & Play)
1. **Download:** Get the latest `SpotifyToolkit.exe` from the [Releases](https://github.com/DarksAces/Spotify-Toolkit/releases) section.
2. **No Setup Required:** The official executable is pre-configured. You **don't** need to create a Spotify Developer account or deal with Client IDs.
3. **🛡️ Security Note:** > [!IMPORTANT]
> As an Open Source project without a paid digital signature, Windows SmartScreen might flag the file. This is a **False Positive**.
> - **Browser:** Select "Keep" or "Download anyway".
> - **Windows:** Click "More info" → **"Run anyway"**.
### ✨ Key Features
* **🌍 Smart i18n:** Automatic interface switching between English and Spanish.
* **🖱️ Modern GUI:** Integrated interactive console—no more external terminal windows.
* **🔍 Instant Search:** Filter and find your playlists instantly by typing their names.
* **⚡ Live Control:** Real-time logging and an instant **Cancel** button to stop any process.
* **📦 Modular Tools:** Duplicate removal, library stats, smart shuffling, and more.
### 📖 How to Use
1. Launch `SpotifyToolkit.exe`.
2. Choose a tool from the sidebar.
3. Interact using the **bottom input bar** and press **Enter**.
4. Authorize via your browser (one-time setup).
---
## 🇪🇸 Versión en Español
### 🚀 Inicio Rápido (Plug & Play)
1. **Descarga:** Consigue el último `SpotifyToolkit.exe` en la sección de [Releases](https://github.com/DarksAces/Spotify-Toolkit/releases).
2. **Sin Configuración:** El ejecutable oficial ya viene configurado. **No** necesitas crear una cuenta de desarrollador ni configurar Client IDs.
3. **🛡️ Nota de Seguridad:**
> [!IMPORTANT]
> Al ser un proyecto Open Source sin firma digital de pago, Windows SmartScreen podría marcarlo. Es un **Falso Positivo**.
> - **Navegador:** Elige "Conservar" o "Descargar de todos modos".
> - **Windows:** Haz clic en "Más información" → **"Ejecutar de todos modos"**.
### ✨ Características Principales
* **🌍 Idioma Automático:** Interfaz dual (Inglés/Español) según la configuración de tu sistema.
* **🖱️ Interfaz Moderna:** Consola interactiva integrada; olvida las ventanas de terminal externas.
* **🔍 Búsqueda Inteligente:** Filtra y selecciona tus playlists al instante escribiendo su nombre.
* **⚡ Control en Vivo:** Visualiza el progreso en tiempo real y detén procesos con el botón **Cancelar**.
* **📦 Herramientas Modulares:** Limpieza de duplicados, estadísticas, Smart Shuffle y más.
### 📖 Modo de Uso
1. Inicia `SpotifyToolkit.exe`.
2. Selecciona una herramienta en el menú lateral.
3. Usa la **barra de entrada inferior** para interactuar y pulsa **Enter**.
4. Inicia sesión en el navegador cuando se te solicite (solo la primera vez).
---
## 🛠️ For Developers / Para Desarrolladores
### Run from source:
```bash
git clone [https://github.com/DarksAces/Spotify-Toolkit.git](https://github.com/DarksAces/Spotify-Toolkit.git)
cd Spotify-Toolkit
pip install -r requirements.txt
# Copy .env.example to .env and fill your credentials
python main.py
```
## 🧠 Architecture / Arquitectura
* **Secret Injection:** GitHub Actions (`build.yml`) injects API keys during compilation to ensure a **"Plug & Play"** experience for end-users without exposing sensitive credentials in the source code.
* **Async Execution:** All tools run on **separate threads** using Python's `threading` module to prevent the GUI from freezing during long-running API operations.
* **Standardized I/O:** A custom engine routes `stdout` directly to the UI's internal console and redirects user `stdin` via the integrated input bar.
---
## 🤝 Community & Support
Join our community to help shape the future of **Spotify Toolkit**!
* **🙋 [Questions & Help](https://github.com/DarksAces/Spotify-Toolkit/discussions/categories/q-a)** – Stuck with something? Ask the community for a hand.
* **💡 [Feature Requests](https://github.com/DarksAces/Spotify-Toolkit/discussions/categories/ideas)** – Have a cool idea? Suggest it here and let others vote.
* **🚀 [Show & Tell](https://github.com/DarksAces/Spotify-Toolkit/discussions/categories/show-and-tell)** – Share how you are using the toolkit or show off your curated playlists!
* **🐛 [Bug Reports](https://github.com/DarksAces/Spotify-Toolkit/issues)** – Found a technical issue? Open a formal ticket so we can fix it.
---
*Distributed under the **MIT License**. Developed with ❤️ for music lovers.*