Auf dieser Seite6 Abschnitte ▾
Die CLI von Free Your Music bringt die Web-App von Free Your Music in dein Terminal. Sie nutzt dein Free-Your-Music-Konto und sieht deshalb dieselben verbundenen Dienste, Übertragungen und Playlists wie die Web-App. Die CLI gehört zu Pro.
Was du brauchst
- Node.js 20 oder neuer mit npm, unter macOS, Windows oder Linux.
- Ein Free-Your-Music-Konto mit Pro: dasselbe Konto, das du unter freeyourmusic.com/app nutzt.
Installieren und anmelden
Die CLI von Free Your Music installieren und dich anmelden
- Führe in einem Terminal npm i -g @freeyourmusic/cli aus.
- Führe fym login aus. Dein Browser öffnet freeyourmusic.com/app/cli, und das Terminal zeigt einen kurzen Code.
- Melde dich per E-Mail, Apple oder Google an. Prüfe, ob der Code im Browser mit dem Code im Terminal übereinstimmt, und tippe dann auf Erlauben. Ohne Pro bietet dir die Seite zuerst Pro an.
- Führe fym services connect spotify (oder einen anderen Dienst) aus und melde dich im Browser bei diesem Dienst an.
- Führe fym library playlists aus, um deine Playlists zu sehen.
Auf einem Computer ohne Browser führst du fym login --no-browser aus und öffnest den Link auf deinem Handy. Die Sitzung hält, solange du sie nutzt: Die CLI erneuert sie von selbst. fym logout meldet diesen Computer ab.
Was kann ich damit tun?
| Gruppe | Was sie tut |
|---|---|
| status, services, accounts | Anmeldestatus, Musikdienste verbinden und neu verbinden, Konten auflisten |
| library, search | Playlists, Lieblingssongs, Alben und Künstler lesen; einen Dienst durchsuchen |
| transfers | Übertragungen starten, verfolgen, pausieren, fortsetzen, erneut versuchen und löschen; Synchron halten |
| playlists, covers | Erstellen, bearbeiten, sortieren, mischen, Duplikate entfernen, aufteilen, zusammenführen, kopieren, eine Version wiederherstellen, Cover |
| matches | Songs ohne Treffer prüfen und einen Ersatz wählen |
| insights, stats, exports | Playlist-Einblicke, Hörstatistiken, Bibliotheksexporte |
| account, premium, notifications | Dein Konto, Pro-Tarife und Bezahlvorgang, Lizenzschlüssel, E-Mail-Einstellungen |
Führe fym help für alle Befehle aus und hänge --help an einen Befehl, um seine Optionen zu sehen. Hänge --json an einen beliebigen Befehl, um eine Ausgabe zu bekommen, die Skripte lesen können. Befehle, die Daten löschen oder ersetzen, brauchen --yes. Es gibt kein Abbrechen einer Übertragung: Pausiere oder lösche sie.
Exit-Codes
| Code | Bedeutung | Was du tun kannst |
|---|---|---|
| 0 | Erfolg | Nichts. |
| 1 | Eine falsche Eingabe, oder der Server hat die Eingabe abgelehnt | Prüfe den Befehl mit --help. |
| 2 | Du bist nicht angemeldet, oder die Sitzung ist abgelaufen | Führe fym login aus. |
| 3 | Free Your Music war nicht erreichbar | Prüfe deine Verbindung und versuche es erneut. |
| 4 | Der Befehl braucht Pro | Führe fym premium plans aus und hol dir Pro. |
| 5 | Zu viele Anfragen | Warte kurz und versuche es erneut. |
Wie sie funktioniert und was privat bleibt
Die CLI ruft die API von Free Your Music über HTTPS auf, wie die Web-App. Nachdem du auf Erlauben getippt hast, speichert sie deine Sitzung in ~/.fym/credentials.json, einer Datei, die nur dein Benutzerkonto lesen kann. Die Anmeldungen bei deinen Musikdiensten bleiben auf den Servern von Free Your Music; die CLI sieht deine Passwörter nie.
Für Skripte und CI setzt du FYM_TOKEN, statt dich anzumelden. fym account sign-out-everywhere beendet jede andere Sitzung deines Kontos, im Web, in den Apps und in anderen CLIs.
Die CLI fügt kein Tracking hinzu. Veröffentlichte Versionen melden unerwartete Fehler an unser Absturzberichts-Tool, ohne deine Befehlsargumente oder Zugangsdaten. Setze FYM_DISABLE_TELEMETRY=1, um das auszuschalten.
Häufige Fragen
Ist die CLI kostenlos?
Nein. Die CLI und der MCP-Server gehören zu Pro. Übertragungen sind in der Web-App und in den Apps für iPhone und Android kostenlos.
Wie wechsle ich in der CLI zu Pro?
Führe fym premium plans aus, um die Tarife zu sehen, und dann fym premium buy mit dem gewünschten Tarif. Du bekommst einen Link zum Bezahlvorgang, den du im Browser öffnest.
Soll ich die CLI oder den MCP-Server nutzen?
Nutze die CLI für Skripte, Cronjobs und CI. Nutze den MCP-Server, wenn ein KI-Assistent im Chat mit deiner Musik arbeiten soll. Beide teilen sich eine Anmeldung auf deinem Computer.
Brauchst du Hilfe mit der CLI? Kontaktiere den Support und füge die Ausgabe von fym status ein.