$ fym library playlistsNAME          SERVICE        SONGS
Road Trip     spotify          112
Deep Focus    apple-music       64
Late Night    tidal             38

A sua música, em scripts.

fym leva a aplicação web do Free Your Music para o seu terminal. Transfira playlists entre 12 serviços, use as ferramentas de playlist, acompanhe as transferências e exporte relatórios. Incluído no Free Your Music Pro. Sem aplicação de desktop: basta o Node.js 20 ou mais recente.

npm i -g @freeyourmusic/cli

12 serviços de músicaUma conta liga-os a todos

Sem aplicação de desktopSó instala o Node.js 20

Um único início de sessão no navegadorEmail, Apple ou Google, aprovado com um código

Comece com quatro comandos

npm i -g @freeyourmusic/cli
fym login
fym services connect spotify
fym library playlists

fym login abre freeyourmusic.com/app/cli com um código curto. Inicie sessão com email, Apple ou Google, confirme o código e toque em Permitir. Num servidor sem navegador, adicione --no-browser e abra a ligação no telemóvel.

Os comandos que vai usar mais

Existe um comando para cada operação da API web do Free Your Music. Execute fym help para os ver todos e adicione --help a qualquer comando para ver as suas opções.

BIBLIOTECA E PESQUISA

fym statusfym accounts listfym library playlists --account-id <id>fym library tracks --account-uuid <id> --entity-type playlists --collection-raw-id <playlist>fym search --account-id <id> --q "phoebe bridgers"fym playlists create --account-id <id> --name "Road Trip"fym stats section get --section <section> --range <range> --account-id <id>

TRANSFERÊNCIAS E SINCRONIZAÇÃO

fym transfers create --input @transfer.jsonfym transfers listfym transfers progressfym transfers set-sync --transfer-uuid <id> --enabled truefym matches unmatchedfym exports create --input @export.jsonfym watch

FERRAMENTAS DE PLAYLIST

fym playlists preview --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists apply-tool --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists edits --account-id <id> --playlist-id <playlist> --ops @ops.jsonfym playlists merge --input @merge.json --yesfym playlists versions --account-id <id> --playlist-id <playlist>fym playlists restore --account-id <id> --playlist-id <playlist> ...fym insights playlist --account-id <id> --playlist-id <playlist>

Feita para scripts

Adicione --json a qualquer comando e encaminhe a resposta para jq, um script ou um agente. O código de saída diz ao seu script o que aconteceu: 2 significa iniciar sessão de novo, 4 significa que o comando precisa de Pro, 5 significa abrandar.

fym library playlists --json | jq -r '.items[] | "\(.trackCount)\t\(.name)"'

Seguro em cron e CI

Defina FYM_TOKEN com um token de conta e a CLI nunca abre um navegador. Os comandos que eliminam ou substituem dados, como playlists delete ou uma fusão, param a menos que adicione --yes, para que um script não possa eliminar nada por engano.

CLI ou servidor MCP?

Ideal para	CLI: scripts, tarefas cron e CI. MCP: uma conversa com o Claude, o Cursor ou o Cline.
Início de sessão	A mesma aprovação no navegador. Ambos partilham uma sessão no seu computador.
Saída	CLI: tabelas, ou JSON com --json. MCP: resultados de ferramentas estruturados.
Funcionalidades	As mesmas: tudo o que a aplicação web do Free Your Music faz.

A mesma conta, as mesmas regras. Escolha o que se adequa à tarefa, ou use ambos.

Grátis e Pro

Grátis

Na aplicação web do Free Your Music e nas apps móveis: ligue os seus serviços, transfira playlists, músicas favoritas, álbuns e artistas até 10.000 músicas no total, escolha substitutos para as músicas sem correspondência, use as estatísticas e exporte as músicas que não passaram.

Pro

O servidor MCP e a CLI. Mantenha as transferências sincronizadas. Edite, ordene, baralhe, remova duplicados, divida, junte e restaure playlists. Estatísticas de playlists.

Privacidade

A CLI e o servidor MCP são executados no seu computador. Chamam a API do Free Your Music por HTTPS com a sessão da sua conta, que fica em ~/.fym/credentials.json e que só o seu utilizador pode ler. As credenciais dos seus serviços de música ficam encriptadas nos servidores do Free Your Music e nunca chegam à sua aplicação de IA. Já os resultados das ferramentas vão para a sua aplicação de IA, e o que ela faz com eles depende das suas definições e do seu fornecedor de modelos.

A sua aplicação de IA ou terminal→API do Free Your Music (HTTPS)→Os seus serviços de música

Dê ao seu assistente as chaves da sua música.

Copie um comando, reinicie a sua aplicação de IA e peça-lhe que inicie a sua sessão.

Instalar em

npx -y @freeyourmusic/mcp install --host=claude-desktop

Grava em ~/Library/Application Support/Claude/claude_desktop_config.json
Feche completamente o Claude Desktop (cmd+Q no macOS) e abra-o de novo. As ferramentas aparecem no servidor freeyourmusic.

Ver todas as ferramentas MCP →Trabalha num terminal? Obtenha a CLI →