Sur cette page6 parties ▾
La CLI Free Your Music met l'application web Free Your Music dans votre terminal. Elle utilise votre compte Free Your Music : elle voit donc les mêmes services connectés, transferts et playlists que l'application web. La CLI fait partie de Pro.
Ce dont vous avez besoin
- Node.js 20 ou plus récent avec npm, sous macOS, Windows ou Linux.
- Un compte Free Your Music avec Pro : le même compte que sur freeyourmusic.com/app.
Installer et se connecter
Installer la CLI Free Your Music et se connecter
- Dans un terminal, lancez npm i -g @freeyourmusic/cli.
- Lancez fym login. Votre navigateur ouvre freeyourmusic.com/app/cli et le terminal affiche un code court.
- Connectez-vous par e-mail, Apple ou Google. Vérifiez que le code du navigateur correspond à celui du terminal, puis touchez Autoriser. Sans Pro, la page propose d'abord Pro.
- Lancez fym services connect spotify (ou un autre service) et connectez-vous à ce service dans le navigateur.
- Lancez fym library playlists pour voir vos playlists.
Sur un ordinateur sans navigateur, lancez fym login --no-browser et ouvrez le lien sur votre téléphone. La session dure tant que vous l'utilisez : la CLI la renouvelle toute seule. fym logout déconnecte cet ordinateur.
Que puis-je faire avec ?
| Groupe | Ce que cela fait |
|---|---|
| status, services, accounts | État de connexion, connecter et reconnecter des services de musique, lister les comptes |
| library, search | Lire les playlists, titres aimés, albums et artistes ; chercher sur un service |
| transfers | Lancer, suivre, mettre en pause, reprendre, réessayer et supprimer des transferts ; Garder synchronisé |
| playlists, covers | Créer, modifier, trier, mélanger, supprimer les doublons, diviser, fusionner, copier, restaurer une version, pochettes |
| matches | Vérifier les titres non associés et choisir un remplacement |
| insights, stats, exports | Statistiques de playlist, statistiques d'écoute, exports de bibliothèque |
| account, premium, notifications | Votre compte, les formules Pro et le paiement, les clés de licence, les réglages e-mail |
Lancez fym help pour voir toutes les commandes et ajoutez --help à une commande pour ses options. Ajoutez --json à n'importe quelle commande pour obtenir une sortie lisible par des scripts. Les commandes qui suppriment ou remplacent des données exigent --yes. Il n'y a pas d'annulation de transfert : mettez en pause ou supprimez un transfert.
Codes de sortie
| Code | Signification | Que faire |
|---|---|---|
| 0 | Succès | Rien. |
| 1 | Une saisie incorrecte, ou le serveur a refusé la saisie | Vérifiez la commande avec --help. |
| 2 | Vous n'êtes pas connecté, ou la session a pris fin | Lancez fym login. |
| 3 | Free Your Music n'a pas pu être joint | Vérifiez votre connexion et réessayez. |
| 4 | La commande nécessite Pro | Lancez fym premium plans et prenez Pro. |
| 5 | Trop de requêtes | Attendez un instant et réessayez. |
Fonctionnement et confidentialité
La CLI appelle l'API Free Your Music en HTTPS, comme l'application web. Une fois que vous avez touché Autoriser, elle garde votre session dans ~/.fym/credentials.json, un fichier que seul votre compte utilisateur peut lire. Vos connexions aux services de musique restent sur les serveurs de Free Your Music ; la CLI ne voit jamais vos mots de passe.
Pour les scripts et la CI, définissez FYM_TOKEN au lieu de vous connecter. fym account sign-out-everywhere met fin à toutes les autres sessions de votre compte, sur le web, dans les applications et dans les autres CLI.
La CLI n'ajoute aucun pistage. Les versions publiées signalent les erreurs inattendues à notre outil de rapport de plantage, sans les arguments de vos commandes ni vos identifiants. Définissez FYM_DISABLE_TELEMETRY=1 pour le désactiver.
Questions fréquentes
La CLI est-elle gratuite ?
Non. La CLI et le serveur MCP font partie de Pro. Les transferts sont gratuits dans l'application web et dans les applications iPhone et Android.
Comment passer à Pro depuis la CLI ?
Lancez fym premium plans pour voir les formules, puis fym premium buy avec la formule voulue. Vous obtenez un lien de paiement à ouvrir dans le navigateur.
Dois-je utiliser la CLI ou le serveur MCP ?
Utilisez la CLI pour les scripts, les tâches cron et la CI. Utilisez le serveur MCP quand vous voulez demander à un assistant IA de gérer votre musique dans une conversation. Les deux partagent une seule connexion sur votre ordinateur.
Besoin d'aide avec la CLI ? Contactez le support et collez la sortie de fym status.