En esta página6 secciones ▾
La CLI de Free Your Music lleva la app web de Free Your Music a tu terminal. Usa tu cuenta de Free Your Music, así que ve los mismos servicios conectados, transferencias y playlists que la app web. La CLI forma parte de Pro.
Qué necesitas
- Node.js 20 o posterior con npm, en macOS, Windows o Linux.
- Una cuenta de Free Your Music con Pro: la misma cuenta que usas en freeyourmusic.com/app.
Instalar e iniciar sesión
Instala la CLI de Free Your Music e inicia sesión
- En una terminal, ejecuta npm i -g @freeyourmusic/cli.
- Ejecuta fym login. Tu navegador abre freeyourmusic.com/app/cli y la terminal muestra un código corto.
- Inicia sesión con tu correo, Apple o Google. Comprueba que el código del navegador coincide con el de la terminal y toca Permitir. Sin Pro, la página te ofrece Pro primero.
- Ejecuta fym services connect spotify (u otro servicio) e inicia sesión en ese servicio en el navegador.
- Ejecuta fym library playlists para ver tus playlists.
En un ordenador sin navegador, ejecuta fym login --no-browser y abre el enlace en tu móvil. La sesión dura mientras la usas: la CLI la renueva sola. fym logout cierra la sesión en este ordenador.
¿Qué puedo hacer con ella?
| Grupo | Qué hace |
|---|---|
| status, services, accounts | Estado de la sesión, conectar y volver a conectar servicios de música, listar cuentas |
| library, search | Leer playlists, canciones que te gustan, álbumes y artistas; buscar en un servicio |
| transfers | Iniciar, seguir, pausar, reanudar, reintentar y eliminar transferencias; Mantener sincronizado |
| playlists, covers | Crear, editar, ordenar, mezclar, quitar duplicados, dividir, combinar, copiar, restaurar una versión, portadas |
| matches | Revisar canciones que no coincidieron y elegir una sustituta |
| insights, stats, exports | Datos de playlists, estadísticas de escucha, exportaciones de la biblioteca |
| account, premium, notifications | Tu cuenta, planes Pro y pago, claves de licencia, ajustes de correo |
Ejecuta fym help para ver todos los comandos y añade --help a un comando para ver sus opciones. Añade --json a cualquier comando para obtener una salida que los scripts puedan leer. Los comandos que eliminan o sustituyen datos necesitan --yes. No existe cancelar una transferencia: pausa o elimina la transferencia.
Códigos de salida
| Código | Significado | Qué hacer |
|---|---|---|
| 0 | Éxito | Nada. |
| 1 | Una entrada incorrecta, o el servidor rechazó la entrada | Revisa el comando con --help. |
| 2 | No has iniciado sesión, o la sesión terminó | Ejecuta fym login. |
| 3 | No se pudo conectar con Free Your Music | Revisa tu conexión y vuelve a intentarlo. |
| 4 | El comando necesita Pro | Ejecuta fym premium plans y consigue Pro. |
| 5 | Demasiadas solicitudes | Espera un momento y vuelve a intentarlo. |
Cómo funciona y qué sigue siendo privado
La CLI llama a la API de Free Your Music por HTTPS, igual que la app web. Después de tocar Permitir, guarda tu sesión en ~/.fym/credentials.json, un archivo que solo tu usuario puede leer. Los inicios de sesión de tus servicios de música se quedan en los servidores de Free Your Music; la CLI nunca ve tus contraseñas.
Para scripts y CI, define FYM_TOKEN en lugar de iniciar sesión. fym account sign-out-everywhere cierra todas las demás sesiones de tu cuenta, en la web, en las apps y en otras CLI.
La CLI no añade ningún rastreo. Las versiones publicadas envían los errores inesperados a nuestra herramienta de informes de fallos, sin los argumentos de tus comandos ni tus credenciales. Define FYM_DISABLE_TELEMETRY=1 para desactivarlo.
Preguntas frecuentes
¿La CLI es gratis?
No. La CLI y el servidor MCP forman parte de Pro. Las transferencias son gratis en la app web y en las apps de iPhone y Android.
¿Cómo me paso a Pro desde la CLI?
Ejecuta fym premium plans para ver los planes y luego fym premium buy con el plan que quieras. Te da un enlace de pago para abrir en el navegador.
¿Uso la CLI o el servidor MCP?
Usa la CLI para scripts, tareas cron y CI. Usa el servidor MCP cuando quieras pedirle a un asistente de IA que trabaje con tu música en un chat. Las dos comparten un mismo inicio de sesión en tu ordenador.
¿Necesitas ayuda con la CLI? Contacta con soporte y pega la salida de fym status.