{"id":48744911,"url":"https://github.com/darksaces/spotify-toolkit","last_synced_at":"2026-04-26T12:00:32.122Z","repository":{"id":344060041,"uuid":"1180262664","full_name":"DarksAces/Spotify-Toolkit","owner":"DarksAces","description":"A powerful Spotify management toolkit built with Python and CustomTkinter. Automate your music library with a modern GUI.","archived":false,"fork":false,"pushed_at":"2026-04-26T10:06:27.000Z","size":128,"stargazers_count":1,"open_issues_count":8,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T11:24:28.639Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DarksAces.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-12T21:40:46.000Z","updated_at":"2026-04-26T10:17:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DarksAces/Spotify-Toolkit","commit_stats":null,"previous_names":["darksaces/spotify-toolkit"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/DarksAces/Spotify-Toolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarksAces%2FSpotify-Toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarksAces%2FSpotify-Toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarksAces%2FSpotify-Toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarksAces%2FSpotify-Toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DarksAces","download_url":"https://codeload.github.com/DarksAces/Spotify-Toolkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DarksAces%2FSpotify-Toolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32296259,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-04-12T10:02:18.039Z","updated_at":"2026-04-26T12:00:32.102Z","avatar_url":"https://github.com/DarksAces.png","language":"Python","readme":"# 🎵 Spotify Toolkit\n\n![GitHub release](https://img.shields.io/github/v/release/DarksAces/Spotify-Toolkit?style=for-the-badge\u0026color=1DB954)\n![GitHub stars](https://img.shields.io/github/stars/DarksAces/Spotify-Toolkit?style=for-the-badge\u0026color=white)\n![Python Version](https://img.shields.io/badge/python-3.9+-yellow?style=for-the-badge\u0026logo=python)\n![GitHub Discussions](https://img.shields.io/github/discussions/DarksAces/Spotify-Toolkit?style=for-the-badge\u0026color=89dceb\u0026label=Community\u0026logo=github)\n![GitHub license](https://img.shields.io/github/license/DarksAces/Spotify-Toolkit?style=for-the-badge\u0026color=1DB954)\n\nA 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.\n\n---\n\n## 🇺🇸 English Version\n\n### 🚀 Quick Start (Plug \u0026 Play)\n\n1.  **Download:** Get the latest `SpotifyToolkit.exe` from the [Releases](https://github.com/DarksAces/Spotify-Toolkit/releases) section.\n2.  **No Setup Required:** The official executable is pre-configured. You **don't** need to create a Spotify Developer account or deal with Client IDs.\n3.  **🛡️ Security Note:** \u003e [!IMPORTANT]\n    \u003e As an Open Source project without a paid digital signature, Windows SmartScreen might flag the file. This is a **False Positive**.\n    \u003e - **Browser:** Select \"Keep\" or \"Download anyway\".\n    \u003e - **Windows:** Click \"More info\" → **\"Run anyway\"**.\n\n### ✨ Key Features\n* **🌍 Smart i18n:** Automatic interface switching between English and Spanish.\n* **🖱️ Modern GUI:** Integrated interactive console—no more external terminal windows.\n* **🔍 Instant Search:** Filter and find your playlists instantly by typing their names.\n* **⚡ Live Control:** Real-time logging and an instant **Cancel** button to stop any process.\n* **📦 Modular Tools:** Duplicate removal, library stats, smart shuffling, and more.\n\n### 📖 How to Use\n1.  Launch `SpotifyToolkit.exe`.\n2.  Choose a tool from the sidebar.\n3.  Interact using the **bottom input bar** and press **Enter**.\n4.  Authorize via your browser (one-time setup).\n\n---\n\n## 🇪🇸 Versión en Español\n\n### 🚀 Inicio Rápido (Plug \u0026 Play)\n\n1.  **Descarga:** Consigue el último `SpotifyToolkit.exe` en la sección de [Releases](https://github.com/DarksAces/Spotify-Toolkit/releases).\n2.  **Sin Configuración:** El ejecutable oficial ya viene configurado. **No** necesitas crear una cuenta de desarrollador ni configurar Client IDs.\n3.  **🛡️ Nota de Seguridad:**\n    \u003e [!IMPORTANT]\n    \u003e Al ser un proyecto Open Source sin firma digital de pago, Windows SmartScreen podría marcarlo. Es un **Falso Positivo**.\n    \u003e - **Navegador:** Elige \"Conservar\" o \"Descargar de todos modos\".\n    \u003e - **Windows:** Haz clic en \"Más información\" → **\"Ejecutar de todos modos\"**.\n\n### ✨ Características Principales\n* **🌍 Idioma Automático:** Interfaz dual (Inglés/Español) según la configuración de tu sistema.\n* **🖱️ Interfaz Moderna:** Consola interactiva integrada; olvida las ventanas de terminal externas.\n* **🔍 Búsqueda Inteligente:** Filtra y selecciona tus playlists al instante escribiendo su nombre.\n* **⚡ Control en Vivo:** Visualiza el progreso en tiempo real y detén procesos con el botón **Cancelar**.\n* **📦 Herramientas Modulares:** Limpieza de duplicados, estadísticas, Smart Shuffle y más.\n\n### 📖 Modo de Uso\n1.  Inicia `SpotifyToolkit.exe`.\n2.  Selecciona una herramienta en el menú lateral.\n3.  Usa la **barra de entrada inferior** para interactuar y pulsa **Enter**.\n4.  Inicia sesión en el navegador cuando se te solicite (solo la primera vez).\n\n---\n\n## 🛠️ For Developers / Para Desarrolladores\n\n### Run from source:\n```bash\ngit clone [https://github.com/DarksAces/Spotify-Toolkit.git](https://github.com/DarksAces/Spotify-Toolkit.git)\ncd Spotify-Toolkit\npip install -r requirements.txt\n# Copy .env.example to .env and fill your credentials\npython main.py\n```\n## 🧠 Architecture / Arquitectura\n\n* **Secret Injection:** GitHub Actions (`build.yml`) injects API keys during compilation to ensure a **\"Plug \u0026 Play\"** experience for end-users without exposing sensitive credentials in the source code.\n* **Async Execution:** All tools run on **separate threads** using Python's `threading` module to prevent the GUI from freezing during long-running API operations.\n* **Standardized I/O:** A custom engine routes `stdout` directly to the UI's internal console and redirects user `stdin` via the integrated input bar.\n\n---\n\n## 🤝 Community \u0026 Support\n\nJoin our community to help shape the future of **Spotify Toolkit**! \n\n* **🙋 [Questions \u0026 Help](https://github.com/DarksAces/Spotify-Toolkit/discussions/categories/q-a)** – Stuck with something? Ask the community for a hand.\n* **💡 [Feature Requests](https://github.com/DarksAces/Spotify-Toolkit/discussions/categories/ideas)** – Have a cool idea? Suggest it here and let others vote.\n* **🚀 [Show \u0026 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!\n* **🐛 [Bug Reports](https://github.com/DarksAces/Spotify-Toolkit/issues)** – Found a technical issue? Open a formal ticket so we can fix it.\n\n---\n\n*Distributed under the **MIT License**. Developed with ❤️ for music lovers.*\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarksaces%2Fspotify-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarksaces%2Fspotify-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarksaces%2Fspotify-toolkit/lists"}