CLI und KI-Tools

Die CLI von Free Your Music

Gilt für
  • macOS
  • Windows
  • Linux
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

  1. Führe in einem Terminal npm i -g @freeyourmusic/cli aus.
  2. Führe fym login aus. Dein Browser öffnet freeyourmusic.com/app/cli, und das Terminal zeigt einen kurzen Code.
  3. 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.
  4. Führe fym services connect spotify (oder einen anderen Dienst) aus und melde dich im Browser bei diesem Dienst an.
  5. 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?

GruppeWas sie tut
status, services, accountsAnmeldestatus, Musikdienste verbinden und neu verbinden, Konten auflisten
library, searchPlaylists, Lieblingssongs, Alben und Künstler lesen; einen Dienst durchsuchen
transfersÜbertragungen starten, verfolgen, pausieren, fortsetzen, erneut versuchen und löschen; Synchron halten
playlists, coversErstellen, bearbeiten, sortieren, mischen, Duplikate entfernen, aufteilen, zusammenführen, kopieren, eine Version wiederherstellen, Cover
matchesSongs ohne Treffer prüfen und einen Ersatz wählen
insights, stats, exportsPlaylist-Einblicke, Hörstatistiken, Bibliotheksexporte
account, premium, notificationsDein 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

CodeBedeutungWas du tun kannst
0ErfolgNichts.
1Eine falsche Eingabe, oder der Server hat die Eingabe abgelehntPrüfe den Befehl mit --help.
2Du bist nicht angemeldet, oder die Sitzung ist abgelaufenFühre fym login aus.
3Free Your Music war nicht erreichbarPrüfe deine Verbindung und versuche es erneut.
4Der Befehl braucht ProFühre fym premium plans aus und hol dir Pro.
5Zu viele AnfragenWarte 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.

Zur CLI-Seite

Brauchst du Hilfe mit der CLI? Kontaktiere den Support und füge die Ausgabe von fym status ein.

Ähnliche Artikel

Kontakt

Kommst du nicht weiter?

Schreib unserem Support-Team an support@freeyourmusic.com. Nenne deine Plattform und was du schon versucht hast.

Am schnellsten: aus der App

  1. Konto
  2. Hilfe und Support
  3. An den Support schreiben

Die E-Mail enthält dann deine Plattform, die App-Version und deine Konto-ID, damit wir schneller helfen können.

Echte Menschen lesen jede E-Mail. Bezahlte Pläne erhalten bevorzugten Support.