Benvenuti nella documentazione di Spotify 2. Qui troverete tutte le informazioni che vi servono.
ChromaWaves, colloquialmente chiamato Spotify 2, è un progetto che porta le funzionalità di Spotify fuori dall’app in sé.
Da quando è nato Spotify, la sua applicazione è stata “moddata” e “craccata” per ottenere musica premium senza effettivamente pagare il servizio, piratando le funzionalità. Nel 2025 però, Spotify ha collaborato con Google per eliminare le applicazioni piratate e farle smettere di funzionare. Un sacco di utenti hanno visto le loro versioni modificate smettere di funzionare e molti si sono iscritti alla versione premium ormai rassegnati dopo aver visto le azioni dell’azienda.
Articolo 1, Articolo 2, Articolo 3, Articolo 4, Articolo 5, Altri articoli…
Così è nato questo progetto:
“invece di cercare di combattere Spotify, cercando di fare una versione craccata che poi verrà rimossa e smetterà di funzionare, creerò il mio personale Spotify!”
- Chroma, 2025
e così mi sono messo a lavoro. E finalmente, dopo 3 mesi di ricerche e test, ci sono riuscito.
Ma come funziona tutto questo?
La piattaforma ha diversi "workers", dei programmi che lavorano insieme per offrire tante diverse funzionalità. Ogni worker ha un nome per differenziarlo ed uno scopo proprio.
Navidrome è un server che usa l’API di subsonic per riprodurre musica in streaming. Essendo un server Navidrome, in realtà ci sono diverse applicazioni per tantissimi sistemi diversi (smartphone, pc, smart home..) che sono compatibili con ChromaWaves! Un vantaggio immenso rispetto ad altre scelte prese in precedenza
Gemy è un webserver che permette l’interazione con SpotDL. Quest’ultimo è un’applicazione che permette di scaricare musica da link Spotify. L’implementazione di SpotDL ha vinto su quella di yt-dlp, per la compatibilità con i link di Spotify.
Gemy, il web server, si occuperà di gestire i download delle canzoni e delle playlist, insieme al trasferimento di queste.
Acon usa la logica da Gemy per aggiornare settimanalmente la libreria di Navidrome. Il programma, infatti, scarica settimanalmente le top 50 canzoni più popolari, assicurando ChromaWaves di essere sempre al passo con i trends.
Bika migliora l'esperienza utente gestendo la registrazione di account navidrome in automatico. Infatti, in passato, era necessario riempire un modulo Google, ed attendere la mia conferma per accedere a Navidrome. Bika permette di gestire le registrazioni utenti in modo automatico.
In fondo alla pagine del downloader, si può notare un contatore di canzoni presenti nella libreria; Ekaj si occupa esattamente di questo: ogni giorno, conta quanti file mp3 sono presenti nella libreria del server e aggiorna il numero nella pagina del Downloader (Gemy). Inoltre, si occupa di tenere il ChromaAPI aggiornato.
Per finire la composizione della pagina del Downloader, Diso si occupa di ottenere l'annuncio più recente e di mostrarlo nella pagina principale. Questo annuncio lo scrivo io su un canale discord privato, via messaggio. Questo messaggio viene poi letto da Diso come forma di bot di discord e salvato come testo per la pagina web.
L’apk di ChromaWaves (app Downloader) è stato creato attraverso “AppCreator24”, un sito web che permette la creazione di APK in modo facile, intuitivo e veloce. La verità dietro all’apk è che in realtà è una “web app”, quindi un modo più carino di vedere la pagina web che si dovrebbe aprire nel browser.
Come precedentemente menzionato, ChromaWaves supporta player diversi, per diversi dispositivi e per diversi scopi.
Puoi vedere la lista nella pagina della documentazione ufficiale di Navidrome:
https://www.navidrome.org/docs/overview/#apps
TUTTI QUESTI CLIENT FUNZIONANO CON CHROMAWAVES!!!