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

Tu música, con scripts.

fym lleva la app web de Free Your Music a tu terminal. Transfiere playlists entre 12 servicios, usa las herramientas de playlist, sigue las transferencias y exporta informes. Incluido en Free Your Music Pro. Sin app de escritorio: basta con Node.js 20 o superior.

npm i -g @freeyourmusic/cli
12 servicios de músicaUna sola cuenta los conecta todos
Sin app de escritorioSolo instalas Node.js 20
Un solo inicio de sesión en el navegadorEmail, Apple o Google, aprobado con un código

Empieza con cuatro comandos

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

fym login abre freeyourmusic.com/app/cli con un código corto. Inicia sesión con email, Apple o Google, comprueba el código y toca Permitir. En un servidor sin navegador, añade --no-browser y abre el enlace en tu móvil.

Los comandos que más usarás

Hay un comando para cada operación de la API web de Free Your Music. Ejecuta fym help para verlos todos y añade --help a cualquier comando para ver sus opciones.

BIBLIOTECA Y BÚSQUEDA

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>

TRANSFERENCIAS Y SINCRONIZACIÓN

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

HERRAMIENTAS 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>

Hecha para scripts

Añade --json a cualquier comando y pasa la respuesta a jq, a un script o a un agente. El código de salida le dice a tu script qué pasó: 2 significa volver a iniciar sesión, 4 significa que el comando necesita Pro, 5 significa ir más despacio.

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

Seguro en cron y CI

Define FYM_TOKEN con un token de cuenta y la CLI nunca abre un navegador. Los comandos que borran o reemplazan datos, como playlists delete o una fusión, se detienen si no añades --yes, así que un script no puede borrar nada por accidente.

¿CLI o servidor MCP?

Ideal paraCLI: scripts, tareas cron y CI. MCP: un chat con Claude, Cursor o Cline.
Inicio de sesiónLa misma aprobación en el navegador. Ambos comparten una sesión en tu ordenador.
SalidaCLI: tablas, o JSON con --json. MCP: resultados de herramientas estructurados.
FuncionesLas mismas: todo lo que puede hacer la app web de Free Your Music.

La misma cuenta, las mismas reglas. Elige el que mejor encaje con la tarea, o usa los dos.

Gratis y Pro

Gratis

En la app web de Free Your Music y en las apps móviles: conecta tus servicios, transfiere playlists, canciones favoritas, álbumes y artistas hasta 10.000 canciones en total, elige sustitutos para las canciones sin coincidencia, usa las estadísticas y exporta las canciones que no se transfirieron.

Pro

El servidor MCP y la CLI. Mantén las transferencias sincronizadas. Edita, ordena, mezcla, quita duplicados, divide, fusiona y restaura playlists. Análisis de playlists.

Privacidad

La CLI y el servidor MCP se ejecutan en tu ordenador. Llaman a la API de Free Your Music por HTTPS con la sesión de tu cuenta, que se guarda en ~/.fym/credentials.json y que solo tu usuario puede leer. Tus credenciales de los servicios de música se quedan cifradas en los servidores de Free Your Music y nunca llegan a tu app de IA. Los resultados de las herramientas sí van a tu app de IA, y lo que haga con ellos depende de su configuración y de su proveedor de modelos.

Tu app de IA o tu terminal→API de Free Your Music (HTTPS)→Tus servicios de música

Dale a tu asistente las llaves de tu música.

Copia un comando, reinicia tu app de IA y pídele que inicie tu sesión.

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

Escribe en ~/Library/Application Support/Claude/claude_desktop_config.json
Cierra Claude Desktop por completo (cmd+Q en macOS) y vuelve a abrirlo. Las herramientas aparecen bajo el servidor freeyourmusic.