Nesta página6 secções ▾
A CLI do Free Your Music leva o app web do Free Your Music para o seu terminal. Usa a sua conta Free Your Music, por isso vê os mesmos serviços conectados, transferências e playlists que o app web. A CLI faz parte do Pro.
O que precisa
- Node.js 20 ou mais recente com npm, em macOS, Windows ou Linux.
- Uma conta Free Your Music com Pro: a mesma conta que usa em freeyourmusic.com/app.
Instalar e iniciar sessão
Instalar a CLI do Free Your Music e iniciar sessão
- Num terminal, execute npm i -g @freeyourmusic/cli.
- Execute fym login. O navegador abre freeyourmusic.com/app/cli e o terminal mostra um código curto.
- Inicie sessão com email, Apple ou Google. Confirme que o código no navegador corresponde ao código no terminal e toque em Permitir. Sem Pro, a página oferece primeiro o Pro.
- Execute fym services connect spotify (ou outro serviço) e inicie sessão nesse serviço no navegador.
- Execute fym library playlists para ver as suas playlists.
Num computador sem navegador, execute fym login --no-browser e abra o link no smartphone. A sessão dura enquanto a usar: a CLI renova-a sozinha. fym logout termina a sessão neste computador.
O que posso fazer com ela?
| Grupo | O que faz |
|---|---|
| status, services, accounts | Estado da sessão, conectar e voltar a conectar serviços de música, listar contas |
| library, search | Ler playlists, músicas curtidas, álbuns e artistas; pesquisar num serviço |
| transfers | Iniciar, acompanhar, pausar, retomar, repetir e eliminar transferências; Manter sincronizado |
| playlists, covers | Criar, editar, ordenar, baralhar, remover duplicados, dividir, juntar, copiar, restaurar uma versão, capas |
| matches | Revisar músicas sem correspondência e escolher uma substituta |
| insights, stats, exports | Análises de playlists, estatísticas de audição, exportações da biblioteca |
| account, premium, notifications | A sua conta, planos Pro e pagamento, chaves de licença, definições de email |
Execute fym help para ver todos os comandos e acrescente --help a um comando para ver as suas opções. Acrescente --json a qualquer comando para obter uma saída que os scripts consigam ler. Os comandos que eliminam ou substituem dados precisam de --yes. Não existe cancelar uma transferência: pause ou elimine a transferência.
Códigos de saída
| Código | Significado | O que fazer |
|---|---|---|
| 0 | Sucesso | Nada. |
| 1 | Uma entrada errada, ou o servidor recusou a entrada | Verifique o comando com --help. |
| 2 | Não iniciou sessão, ou a sessão terminou | Execute fym login. |
| 3 | Não foi possível chegar ao Free Your Music | Verifique a sua ligação à internet e tente de novo. |
| 4 | O comando precisa do Pro | Execute fym premium plans e obtenha o Pro. |
| 5 | Demasiados pedidos | Aguarde um momento e tente de novo. |
Como funciona e o que fica privado
A CLI chama a API do Free Your Music por HTTPS, como faz o app web. Depois de tocar em Permitir, guarda a sua sessão em ~/.fym/credentials.json, um ficheiro que só a sua conta de utilizador do computador pode ler. Os inícios de sessão dos seus serviços de música ficam nos servidores do Free Your Music; a CLI nunca vê as suas palavras-passe.
Para scripts e CI, defina FYM_TOKEN em vez de iniciar sessão. fym account sign-out-everywhere termina todas as outras sessões da sua conta, na web, nos apps e noutras CLIs.
A CLI não acrescenta rastreamento. As versões publicadas comunicam erros inesperados à nossa ferramenta de relatórios de falhas, sem os argumentos dos seus comandos nem credenciais. Defina FYM_DISABLE_TELEMETRY=1 para desativar isso.
Perguntas frequentes
A CLI é grátis?
Não. A CLI e o servidor MCP fazem parte do Pro. As transferências são grátis no app web e nos apps para iPhone e Android.
Como passo para o Pro a partir da CLI?
Execute fym premium plans para ver os planos e depois fym premium buy com o plano que quer. Recebe um link de pagamento para abrir no navegador.
Devo usar a CLI ou o servidor MCP?
Use a CLI para scripts, tarefas cron e CI. Use o servidor MCP quando quiser pedir a um assistente de IA que trabalhe com a sua música numa conversa. Os dois partilham o mesmo início de sessão no seu computador.
Precisa de ajuda com a CLI? Contacte o suporte e cole a saída de fym status.