Op deze pagina6 onderdelen ▾
De CLI van Free Your Music zet de webapp van Free Your Music in je terminal. Hij gebruikt je Free Your Music-account, dus hij ziet dezelfde gekoppelde diensten, overdrachten en playlists als de webapp. De CLI hoort bij Pro.
Wat je nodig hebt
- Node.js 20 of nieuwer met npm, op macOS, Windows of Linux.
- Een Free Your Music-account met Pro: hetzelfde account dat je gebruikt op freeyourmusic.com/app.
Installeren en inloggen
De CLI van Free Your Music installeren en inloggen
- Voer in een terminal npm i -g @freeyourmusic/cli uit.
- Voer fym login uit. Je browser opent freeyourmusic.com/app/cli en de terminal toont een korte code.
- Log in met e-mail, Apple of Google. Controleer of de code in de browser gelijk is aan de code in de terminal en tik op Allow. Zonder Pro biedt de pagina eerst Pro aan.
- Voer fym services connect spotify (of een andere dienst) uit en log in de browser in bij die dienst.
- Voer fym library playlists uit om je playlists te zien.
Op een computer zonder browser voer je fym login --no-browser uit en open je de link op je telefoon. De sessie blijft geldig zolang je hem gebruikt: de CLI vernieuwt hem vanzelf. fym logout logt deze computer uit.
Wat kan ik ermee?
| Groep | Wat het doet |
|---|---|
| status, services, accounts | Inlogstatus, muziekdiensten koppelen en opnieuw koppelen, accounts tonen |
| library, search | Playlists, favoriete nummers, albums en artiesten lezen; zoeken bij een dienst |
| transfers | Overdrachten starten, volgen, pauzeren, hervatten, opnieuw proberen en verwijderen; Gesynchroniseerd houden |
| playlists, covers | Aanmaken, bewerken, sorteren, shuffelen, dubbele nummers verwijderen, splitsen, samenvoegen, kopiëren, een versie herstellen, covers |
| matches | Nummers nakijken die niet matchten en een vervanger kiezen |
| insights, stats, exports | Playlist-inzichten, luisterstatistieken, bibliotheekexports |
| account, premium, notifications | Je account, Pro-abonnementen en betalen, licentiesleutels, e-mailinstellingen |
Voer fym help uit voor alle opdrachten en voeg --help toe aan een opdracht voor de opties. Voeg --json toe aan een opdracht voor uitvoer die scripts kunnen lezen. Opdrachten die gegevens verwijderen of vervangen, hebben --yes nodig. Er is geen opdracht om een overdracht te annuleren: pauzeer of verwijder een overdracht.
Exitcodes
| Code | Betekenis | Wat je doet |
|---|---|---|
| 0 | Gelukt | Niets. |
| 1 | Een verkeerde invoer, of de server weigerde de invoer | Controleer de opdracht met --help. |
| 2 | Je bent niet ingelogd, of de sessie is beëindigd | Voer fym login uit. |
| 3 | Free Your Music was niet bereikbaar | Controleer je verbinding en probeer het opnieuw. |
| 4 | De opdracht vereist Pro | Voer fym premium plans uit en neem Pro. |
| 5 | Te veel verzoeken | Wacht even en probeer het opnieuw. |
Hoe het werkt en wat privé blijft
De CLI roept de API van Free Your Music aan via HTTPS, net als de webapp. Nadat je op Allow hebt getikt, bewaart hij je sessie in ~/.fym/credentials.json, een bestand dat alleen je eigen gebruikersaccount kan lezen. Je inlogs bij muziekdiensten blijven op de servers van Free Your Music; de CLI ziet je wachtwoorden nooit.
Stel voor scripts en CI FYM_TOKEN in in plaats van in te loggen. fym account sign-out-everywhere beëindigt alle andere sessies van je account, op het web, in de apps en in andere CLI's.
De CLI voegt geen tracking toe. Gepubliceerde versies melden onverwachte fouten aan onze crashrapportagetool, zonder de argumenten van je opdrachten of je inloggegevens. Stel FYM_DISABLE_TELEMETRY=1 in om dat uit te zetten.
Veelgestelde vragen
Is de CLI gratis?
Nee. De CLI en de MCP-server horen bij Pro. Overdrachten zijn gratis in de webapp en in de apps voor iPhone en Android.
Hoe stap ik vanuit de CLI over op Pro?
Voer fym premium plans uit om de abonnementen te zien, en dan fym premium buy met het abonnement dat je wilt. Je krijgt een betaallink die je in de browser opent.
Gebruik ik de CLI of de MCP-server?
Gebruik de CLI voor scripts, cronjobs en CI. Gebruik de MCP-server als je een AI-assistent in een chat met je muziek wilt laten werken. Beide delen één inlog op je computer.
Hulp nodig met de CLI? Neem contact op met support en plak de uitvoer van fym status.