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

Deine Musik, per Skript steuerbar.

fym bringt die Free Your Music-Web-App in dein Terminal. Übertrage Playlists zwischen 12 Diensten, nutze Playlist-Tools, verfolge Übertragungen und exportiere Berichte. Teil von Free Your Music Pro. Keine Desktop-App: Node.js 20 oder neuer reicht.

npm i -g @freeyourmusic/cli

12 MusikdiensteEin Konto verbindet sie alle

Keine Desktop-AppDu installierst nur Node.js 20

Eine Anmeldung im BrowserE-Mail, Apple oder Google, bestätigt mit einem Code

Start in vier Befehlen

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

fym login öffnet freeyourmusic.com/app/cli mit einem kurzen Code. Melde dich mit E-Mail, Apple oder Google an, prüfe den Code und tippe auf Erlauben. Auf einem Server ohne Browser fügst du --no-browser an und öffnest den Link auf deinem Handy.

Die Befehle, die du am häufigsten brauchst

Für jede Funktion der Free Your Music-Web-API gibt es einen Befehl. Führe fym help aus, um alle aufzulisten, und hänge --help an einen Befehl an, um seine Optionen zu sehen.

BIBLIOTHEK & SUCHE

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>

ÜBERTRAGUNGEN & SYNC

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

PLAYLIST-TOOLS

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>

Gebaut für Skripte

Hänge --json an einen beliebigen Befehl an und leite die Antwort an jq, ein Skript oder einen Agenten weiter. Der Exit-Code sagt deinem Skript, was passiert ist: 2 heißt neu anmelden, 4 heißt, der Befehl braucht Pro, 5 heißt langsamer machen.

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

Sicher in cron und CI

Setze FYM_TOKEN auf ein Konto-Token, und die CLI öffnet nie einen Browser. Befehle, die Daten löschen oder ersetzen, etwa playlists delete oder ein Zusammenführen, brechen ab, wenn du nicht --yes anfügst. So kann ein Skript nichts aus Versehen löschen.

CLI oder MCP-Server?

Ideal für	CLI: Skripte, Cron-Jobs und CI. MCP: ein Chat mit Claude, Cursor oder Cline.
Anmeldung	Dieselbe Freigabe im Browser. Beide teilen sich eine Sitzung auf deinem Computer.
Ausgabe	CLI: Tabellen oder JSON mit --json. MCP: strukturierte Tool-Ergebnisse.
Funktionen	Gleich: alles, was die Free Your Music-Web-App kann.

Gleiches Konto, gleiche Regeln. Nimm das, was zur Aufgabe passt, oder nutze beides.

Kostenlos und Pro

Kostenlos

In der Free Your Music-Web-App und den Mobil-Apps: deine Dienste verbinden, Playlists, Lieblingssongs, Alben und Künstler ohne Song-Limit übertragen, Ersatz für nicht zugeordnete Songs auswählen, Stats nutzen und die Songs exportieren, die nicht übertragen wurden.

Pro

Der MCP-Server und die CLI. Übertragungen synchron halten. Playlists bearbeiten, sortieren, mischen, von Duplikaten befreien, aufteilen, zusammenführen und wiederherstellen. Playlist-Insights.

Datenschutz

Die CLI und der MCP-Server laufen auf deinem Computer. Sie rufen die Free Your Music-API über HTTPS mit deiner Kontositzung auf. Diese liegt in ~/.fym/credentials.json, und nur dein Benutzer kann sie lesen. Deine Zugangsdaten für Musikdienste bleiben verschlüsselt auf den Free Your Music-Servern und erreichen deine KI-App nie. Tool-Ergebnisse gehen dagegen an deine KI-App, und was sie damit macht, hängt von ihren Einstellungen und ihrem Modellanbieter ab.

Deine KI-App oder dein Terminal→Free Your Music-API (HTTPS)→Deine Musikdienste

Gib deinem Assistenten die Schlüssel zu deiner Musik.

Kopiere einen Befehl, starte deine KI-App neu und bitte sie, dich anzumelden.

Installieren in

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

Schreibt nach ~/Library/Application Support/Claude/claude_desktop_config.json
Beende Claude Desktop vollständig (cmd+Q unter macOS) und öffne es erneut. Die Tools erscheinen unter dem freeyourmusic-Server.

Alle MCP-Tools ansehen →Arbeitest du im Terminal? Hol dir die CLI →