$ fym library playlistsNAME          SERVICE        SONGS
Road Trip     spotify          112
Deep Focus    apple-music       64
Late Night    tidal             38

La tua musica, programmabile.

fym porta l’app web di Free Your Music nel tuo terminale. Trasferisci playlist tra 12 servizi, usa gli strumenti per le playlist, segui i trasferimenti ed esporta report. Incluso in Free Your Music Pro. Nessuna app desktop: basta Node.js 20 o successivo.

npm i -g @freeyourmusic/cli
12 servizi musicaliUn solo account li collega tutti
Nessuna app desktopInstalli solo Node.js 20
Un solo accesso dal browserEmail, Apple o Google, approvato con un codice

Inizia con quattro comandi

npm i -g @freeyourmusic/cli
fym login
fym services connect spotify
fym library playlists

fym login apre freeyourmusic.com/app/cli con un codice breve. Accedi con email, Apple o Google, controlla il codice e tocca Consenti. Su un server senza browser, aggiungi --no-browser e apri il link sul telefono.

I comandi che userai di più

C’è un comando per ogni operazione dell’API web di Free Your Music. Esegui fym help per elencarli tutti e aggiungi --help a qualsiasi comando per vederne le opzioni.

LIBRERIA E RICERCA

fym statusfym accounts listfym library playlists --account-id <id>fym library tracks --account-uuid <id> --entity-type playlists --collection-raw-id <playlist>fym search --account-id <id> --q "phoebe bridgers"fym playlists create --account-id <id> --name "Road Trip"fym stats section get --section <section> --range <range> --account-id <id>

TRASFERIMENTI E SINCRONIZZAZIONE

fym transfers create --input @transfer.jsonfym transfers listfym transfers progressfym transfers set-sync --transfer-uuid <id> --enabled truefym matches unmatchedfym exports create --input @export.jsonfym watch

STRUMENTI PLAYLIST

fym playlists preview --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists apply-tool --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists edits --account-id <id> --playlist-id <playlist> --ops @ops.jsonfym playlists merge --input @merge.json --yesfym playlists versions --account-id <id> --playlist-id <playlist>fym playlists restore --account-id <id> --playlist-id <playlist> ...fym insights playlist --account-id <id> --playlist-id <playlist>

Pensata per gli script

Aggiungi --json a qualsiasi comando e passa la risposta a jq, a uno script o a un agente. Il codice di uscita dice al tuo script cosa è successo: 2 significa accedi di nuovo, 4 significa che il comando richiede Pro, 5 significa rallenta.

fym library playlists --json | jq -r '.items[] | "\(.trackCount)\t\(.name)"'

Sicura in cron e nella CI

Imposta FYM_TOKEN su un token dell’account e la CLI non apre mai un browser. I comandi che eliminano o sostituiscono dati, come playlists delete o un’unione, si fermano se non aggiungi --yes, così uno script non può eliminare nulla per errore.

CLI o server MCP?

Ideale perCLI: script, job cron e CI. MCP: una chat con Claude, Cursor o Cline.
AccessoLa stessa approvazione nel browser. Entrambi condividono una sessione sul tuo computer.
OutputCLI: tabelle, oppure JSON con --json. MCP: risultati strutturati degli strumenti.
FunzioniLe stesse: tutto ciò che fa l’app web di Free Your Music.

Stesso account, stesse regole. Scegli quello adatto al lavoro, oppure usali entrambi.

Gratis e Pro

Gratis

Nell’app web di Free Your Music e nelle app mobili: collega i tuoi servizi, trasferisci playlist, brani preferiti, album e artisti fino a 10.000 brani in totale, scegli i sostituti per i brani senza corrispondenza, usa le statistiche ed esporta i brani che non sono passati.

Pro

Il server MCP e la CLI. Mantieni sincronizzati i trasferimenti. Modifica, ordina, mescola, rimuovi i duplicati, dividi, unisci e ripristina le playlist. Analisi delle playlist.

Privacy

La CLI e il server MCP girano sul tuo computer. Chiamano l’API di Free Your Music via HTTPS con la sessione del tuo account, che si trova in ~/.fym/credentials.json e che solo il tuo utente può leggere. Le credenziali dei tuoi servizi musicali restano cifrate sui server di Free Your Music e non arrivano mai alla tua app di IA. I risultati degli strumenti invece arrivano alla tua app di IA, e ciò che ne fa dipende dalle sue impostazioni e dal suo fornitore del modello.

La tua app di IA o il tuo terminale→API di Free Your Music (HTTPS)→I tuoi servizi musicali

Dai al tuo assistente le chiavi della tua musica.

Copia un comando, riavvia la tua app di IA e chiedile di farti accedere.

Installa in
npx -y @freeyourmusic/mcp install --host=claude-desktop

Scrive in ~/Library/Application Support/Claude/claude_desktop_config.json
Chiudi completamente Claude Desktop (cmd+Q su macOS) e riaprilo. Gli strumenti compaiono sotto il server freeyourmusic.

Vedi tutti gli strumenti MCP →Lavori nel terminale? Scarica la CLI →