A powerful collection of GUI tools to manage, clean, and enhance your Spotify experience. This toolkit uses the Spotify API to give you full control over your playlists, liked songs, and library statistics.
Go to the Releases section on the right and download the latest SpotifyToolkit.exe.
Important
Why does Windows say it's not safe? This tool is Open Source and created with PyInstaller. Since it doesn't have a paid digital signature (which costs hundreds of dollars), Windows SmartScreen and browsers may flag it as "unrecognized" or "dangerous".
It is a False Positive. You can run it safely:
- Browser: Choose "Keep" or "Download anyway".
- Windows (Blue Screen): Click "More info" and then "Run anyway".
Tip
The executable is "Plug & Play". You do NOT need to create a Spotify Dev account or enter your own credentials (Client ID/Secret) if you use the official release. It comes pre-configured and ready to use!
- 🌍 Auto-Language Detection: The app automatically switches between English and Spanish based on your OS settings.
- 📝 Integrated Tool Descriptions: Every tool includes a brief description of its function directly in the UI.
- 🔍 Smart Searching: When choosing a playlist, you can type its name to filter or select it instantly.
- Integrated Interactive Console: No more messy terminal windows. Everything happens inside the app.
- Live Process Control: Change of heart? Use the Cancel button to stop any running script immediately.
- Automatic Discovery: The app automatically lists all your playlists for easy selection.
- Open
SpotifyToolkit.exe. - Select the tool you want to use from the sidebar.
- If a tool needs your input (like choosing a playlist), type it in the bottom input bar of the app and press Enter.
- Log in to Spotify in the browser window if prompted (only required the first time).
Una colección potente de herramientas con interfaz gráfica para gestionar, limpiar y potenciar tu experiencia en Spotify. Este toolkit utiliza la API de Spotify para darte control total sobre tus playlists, canciones favoritas y estadísticas.
Ve a la sección de Releases a la derecha y descarga el último SpotifyToolkit.exe.
Important
¿Por qué Windows dice que no es seguro? Esta herramienta es de código abierto y está creada con PyInstaller. Al no tener una firma digital de pago (que cuesta cientos de euros), Windows SmartScreen y los navegadores pueden marcarlo como "desconocido" o "peligroso".
Es un Falso Positivo. Puedes usarlo con total seguridad:
- Navegador: Elige "Conservar" o "Descargar de todos modos".
- Windows (Pantalla Azul): Haz clic en "Más información" y luego en "Ejecutar de todos modos".
Tip
El ejecutable es "Plug & Play". NO es necesario que crees una cuenta de desarrollador de Spotify ni que pongas tus propias credenciales (Client ID/Secret) si usas la versión oficial. ¡Viene ya configurado y listo para usar!
- 🌍 Idioma Automático: La app detecta si tu PC está en español o inglés y ajusta la interfaz al instante.
- 📝 Descripciones Detalladas: Cada herramienta incluye una breve explicación de qué hace antes de ejecutarla.
- 🔍 Búsqueda Inteligente: Al elegir una playlist, puedes escribir el nombre directamente para filtrar o seleccionar.
- Consola Interactiva Integrada: Se acabaron las ventanas negras de terminal. Todo ocurre dentro de la aplicación.
- Control de Procesos en Vivo: ¿Te arrepentiste? Usa el botón Cancelar para detener cualquier script al instante.
- Descubrimiento Automático: La app lista todas tus playlists automáticamente para que solo tengas que elegir.
- Abre
SpotifyToolkit.exe. - Selecciona la herramienta que quieras usar en el menú lateral.
- Si la herramienta necesita que escribas algo (como elegir una playlist), escríbelo en la barra inferior de la app y pulsa Enter.
- Inicia sesión en Spotify en el navegador si se te solicita (solo la primera vez).
- Clone the repo.
- Install dependencies:
pip install -r requirements.txt. - Create a
.envfile using.env.exampleas a template. - Run
python main.py.
The build process (build.yml) takes GitHub Secrets and injects them into main.py during compilation. This enables the "Plug & Play" experience without exposing keys in public source code.
The app uses a central dictionary in main.py and utils/helpers.py to support multiple languages dynamically based on the system's locale.
To prevent GUI freezing, every tool runs in a separate thread. The main interface captures stdout in real-time and routes user input to the script's stdin.
All modular tools are organized in dedicated folders (e.g., delete_duplicates/, smart_shuffle/) following naming conventions that avoid spaces for better script compatibility.
Distributed under the MIT License. See LICENSE for more information.
Developed with ❤️ for music lovers.