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

Je muziek, scriptbaar.

fym zet de Free Your Music-webapp in je terminal. Zet playlists over tussen 12 diensten, gebruik playlisttools, volg overzettingen en exporteer rapporten. Onderdeel van Free Your Music Pro. Geen desktop-app: Node.js 20 of nieuwer is genoeg.

npm i -g @freeyourmusic/cli

12 muziekdienstenEén account verbindt ze allemaal

Geen desktop-appJe installeert alleen Node.js 20

Eén keer inloggen in de browserE-mail, Apple of Google, goedgekeurd met een code

Begin met vier commando's

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

fym login opent freeyourmusic.com/app/cli met een korte code. Log in met e-mail, Apple of Google, controleer de code en tik op Toestaan. Op een server zonder browser voeg je --no-browser toe en open je de link op je telefoon.

De commando's die je het meest gebruikt

Er is één commando voor elke bewerking van de Free Your Music-web-API. Voer fym help uit om ze allemaal te zien, en voeg --help toe aan een commando om de opties ervan te bekijken.

BIBLIOTHEEK & ZOEKEN

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>

OVERZETTEN & SYNCHRONISEREN

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

PLAYLISTTOOLS

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>

Gemaakt voor scripts

Voeg --json toe aan een commando en stuur het antwoord door naar jq, een script of een agent. De exitcode vertelt je script wat er gebeurde: 2 betekent opnieuw inloggen, 4 betekent dat het commando Pro nodig heeft, 5 betekent rustiger aan.

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

Veilig in cron en CI

Zet FYM_TOKEN op een accounttoken en de CLI opent nooit een browser. Commando's die gegevens verwijderen of vervangen, zoals playlists delete of samenvoegen, stoppen tenzij je --yes toevoegt, zodat een script niet per ongeluk iets kan verwijderen.

CLI of MCP-server?

Het best voor	CLI: scripts, cronjobs en CI. MCP: een chat met Claude, Cursor of Cline.
Inloggen	Dezelfde goedkeuring in de browser. Beide delen één sessie op je computer.
Output	CLI: tabellen, of JSON met --json. MCP: gestructureerde toolresultaten.
Functies	Hetzelfde: alles wat de Free Your Music-webapp kan.

Hetzelfde account, dezelfde regels. Kies wat bij de klus past, of gebruik ze allebei.

Gratis en Pro

Gratis

In de Free Your Music-webapp en de mobiele apps: koppel je diensten, zet playlists, favoriete nummers, albums en artiesten over tot 10.000 nummers in totaal, kies vervangers voor nummers die niet gevonden zijn, gebruik statistieken en exporteer de nummers die niet zijn overgezet.

Pro

De MCP-server en de CLI. Houd overzettingen gesynchroniseerd. Playlists bewerken, sorteren, shufflen, ontdubbelen, splitsen, samenvoegen en herstellen. Playlistinzichten.

Privacy

De CLI en de MCP-server draaien op je computer. Ze roepen de Free Your Music-API aan via HTTPS met je accountsessie, die in ~/.fym/credentials.json staat en die alleen jouw gebruiker kan lezen. Je inloggegevens voor muziekdiensten blijven versleuteld op de servers van Free Your Music en bereiken je AI-app nooit. Toolresultaten gaan wel naar je AI-app, en wat die ermee doet, hangt af van de instellingen en de modelaanbieder van die app.

Je AI-app of terminal→Free Your Music-API (HTTPS)→Je muziekdiensten

Geef je assistent de sleutels van je muziek.

Kopieer één commando, herstart je AI-app en vraag of die je inlogt.

Installeren in

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

Schrijft naar ~/Library/Application Support/Claude/claude_desktop_config.json
Sluit Claude Desktop volledig af (cmd+Q op macOS) en open het opnieuw. De tools verschijnen onder de freeyourmusic-server.

Bekijk alle MCP-tools →Werk je in een terminal? Haal de CLI →