In questa pagina6 sezioni ▾
La CLI di Free Your Music porta la web app di Free Your Music nel tuo terminale. Usa il tuo account Free Your Music, quindi vede gli stessi servizi collegati, trasferimenti e playlist della web app. La CLI fa parte di Pro.
Cosa ti serve
- Node.js 20 o successivo con npm, su macOS, Windows o Linux.
- Un account Free Your Music con Pro: lo stesso account che usi su freeyourmusic.com/app.
Installare e accedere
Installare la CLI di Free Your Music e accedere
- In un terminale, esegui npm i -g @freeyourmusic/cli.
- Esegui fym login. Il browser apre freeyourmusic.com/app/cli e il terminale mostra un codice breve.
- Accedi con email, Apple o Google. Controlla che il codice nel browser corrisponda a quello nel terminale, poi tocca Consenti. Senza Pro, la pagina ti propone prima Pro.
- Esegui fym services connect spotify (o un altro servizio) e accedi a quel servizio nel browser.
- Esegui fym library playlists per vedere le tue playlist.
Su un computer senza browser, esegui fym login --no-browser e apri il link sul telefono. La sessione dura finché la usi: la CLI la rinnova da sola. fym logout ti disconnette da questo computer.
Cosa posso farci?
| Gruppo | Cosa fa |
|---|---|
| status, services, accounts | Stato dell’accesso, collegare e ricollegare servizi musicali, elencare gli account |
| library, search | Leggere playlist, brani preferiti, album e artisti; cercare su un servizio |
| transfers | Avviare, seguire, mettere in pausa, riprendere, riprovare ed eliminare trasferimenti; Mantieni sincronizzato |
| playlists, covers | Creare, modificare, ordinare, mescolare, rimuovere doppioni, dividere, unire, copiare, ripristinare una versione, copertine |
| matches | Controllare i brani non abbinati e sceglierne un sostituto |
| insights, stats, exports | Statistiche delle playlist, Stats di ascolto, esportazioni della libreria |
| account, premium, notifications | Il tuo account, piani Pro e checkout, chiavi di licenza, impostazioni email |
Esegui fym help per vedere tutti i comandi e aggiungi --help a un comando per le sue opzioni. Aggiungi --json a qualsiasi comando per ottenere un output leggibile dagli script. I comandi che eliminano o sostituiscono dati richiedono --yes. Non esiste l’annullamento di un trasferimento: metti in pausa o elimina il trasferimento.
Codici di uscita
| Codice | Significato | Cosa fare |
|---|---|---|
| 0 | Riuscito | Niente. |
| 1 | Un input sbagliato, oppure il server ha rifiutato l’input | Controlla il comando con --help. |
| 2 | Non hai fatto l’accesso, oppure la sessione è terminata | Esegui fym login. |
| 3 | Non è stato possibile raggiungere Free Your Music | Controlla la connessione e riprova. |
| 4 | Il comando richiede Pro | Esegui fym premium plans e passa a Pro. |
| 5 | Troppe richieste | Aspetta un momento e riprova. |
Come funziona e cosa resta privato
La CLI chiama l’API di Free Your Music via HTTPS, come fa la web app. Dopo che tocchi Consenti, conserva la sessione in ~/.fym/credentials.json, un file che solo il tuo utente può leggere. Gli accessi ai tuoi servizi musicali restano sui server di Free Your Music; la CLI non vede mai le tue password.
Per script e CI, imposta FYM_TOKEN invece di accedere. fym account sign-out-everywhere chiude tutte le altre sessioni del tuo account, sul web, nelle app e nelle altre CLI.
La CLI non aggiunge tracciamento. Le versioni pubblicate segnalano gli errori imprevisti al nostro strumento di segnalazione degli arresti anomali, senza gli argomenti dei tuoi comandi né le credenziali. Imposta FYM_DISABLE_TELEMETRY=1 per disattivarlo.
Domande frequenti
La CLI è gratis?
No. La CLI e il server MCP fanno parte di Pro. I trasferimenti sono gratis nella web app e nelle app per iPhone e Android.
Come passo a Pro dalla CLI?
Esegui fym premium plans per vedere i piani, poi fym premium buy con il piano che vuoi. Ti dà un link di checkout da aprire nel browser.
Devo usare la CLI o il server MCP?
Usa la CLI per script, cron job e CI. Usa il server MCP quando vuoi chiedere a un assistente AI di lavorare con la tua musica in una chat. Entrambi condividono un unico accesso sul tuo computer.
Ti serve aiuto con la CLI? Contatta l’assistenza e incolla l’output di fym status.