CLI e ferramentas de IA

A CLI do Free Your Music

Aplica-se a
  • macOS
  • Windows
  • Linux
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

  1. Num terminal, execute npm i -g @freeyourmusic/cli.
  2. Execute fym login. O navegador abre freeyourmusic.com/app/cli e o terminal mostra um código curto.
  3. 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.
  4. Execute fym services connect spotify (ou outro serviço) e inicie sessão nesse serviço no navegador.
  5. 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?

GrupoO que faz
status, services, accountsEstado da sessão, conectar e voltar a conectar serviços de música, listar contas
library, searchLer playlists, músicas curtidas, álbuns e artistas; pesquisar num serviço
transfersIniciar, acompanhar, pausar, retomar, repetir e eliminar transferências; Manter sincronizado
playlists, coversCriar, editar, ordenar, baralhar, remover duplicados, dividir, juntar, copiar, restaurar uma versão, capas
matchesRevisar músicas sem correspondência e escolher uma substituta
insights, stats, exportsAnálises de playlists, estatísticas de audição, exportações da biblioteca
account, premium, notificationsA 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ódigoSignificadoO que fazer
0SucessoNada.
1Uma entrada errada, ou o servidor recusou a entradaVerifique o comando com --help.
2Não iniciou sessão, ou a sessão terminouExecute fym login.
3Não foi possível chegar ao Free Your MusicVerifique a sua ligação à internet e tente de novo.
4O comando precisa do ProExecute fym premium plans e obtenha o Pro.
5Demasiados pedidosAguarde 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.

Ver a página da CLI

Precisa de ajuda com a CLI? Contacte o suporte e cole a saída de fym status.

Artigos relacionados

Contacto

Ainda com dúvidas?

Escreva à nossa equipa de suporte para support@freeyourmusic.com. Indique a sua plataforma e o que já experimentou.

O mais rápido: a partir da app

  1. Conta
  2. Ajuda e suporte
  3. Escrever para o suporte

Assim o email inclui a sua plataforma, a versão da app e o ID da sua conta, e podemos ajudar mais depressa.

Pessoas reais leem cada email. Os planos pagos têm suporte prioritário.