freyr-js

Freyr es una herramienta de línea de comandos para descargar pistas de música de servicios de streaming. Dada una URL o URI corta de Spotify, Apple Music o Deezer, extrae metadatos de la pista (título, artista, álbum, número de pista/disco, fecha de lanzamiento, ISRC, sello, copyright, carátula y más), luego consulta fuentes de audio como YouTube Music para encontrar audio coincidente, descarga el archivo sin procesar, lo codifica a Apple AAC (.m4a) con una tasa de bits configurable (96–320kbps, por defecto 320k), incrusta metadatos y carátula del álbum, y organiza la salida en una estructura de directorios ARTISTA/ÁLBUM/PISTA. Los tipos de consulta admitidos incluyen pistas, álbumes, artistas y listas de reproducción. Las descargas por lotes son posibles pasando múltiples consultas como argumentos o mediante un archivo de entrada (-i/--input) donde cada línea es una consulta y # marca comentarios. Un subcomando urify convierte entre URLs de servicios y URIs cortas compatibles con freyr. Las opciones notables incluyen selección de tasa de bits, descargas de fragmentos concurrentes (-n/--chunks), conteos de reintentos, directorio de salida personalizado, verificación de otros directorios para pistas existentes (-D), nombre y tamaño de carátula o desactivación, orden de preferencia de fuentes (youtube, yt_music, con ! para excluir), filtros de metadatos, ajuste de concurrencia por etapa (queries, tracks, trackStage, downloader, encoder, embedder), bandera de reproducción sin interrupciones, sobrescritura forzada, generación de listas de reproducción (m3u8) con opciones para directorio, anexado, escape y prefijo de espacio de nombres, código de país de tienda, desactivación de organización de árbol, control de directorio de caché, tamaño de caché de memoria, tiempo de espera de red, autenticación y alternancias de lanzamiento de navegador, estilos de barra de progreso y una ruta explícita al binario AtomicParsley. La instalación está disponible vía npm (npm install -g freyr) o Yarn, desde el código fuente, o mediante imágenes oficiales de Docker (freyrcli/freyrjs) con un comando docker run documentado y ejemplo de alias. Los requisitos incluyen Python >= 3.2, Node.js >= 16 y AtomicParsley >= 20230114. El README señala que YouTube Music debe estar disponible en la región del usuario porque el audio sin procesar se obtiene de allí. El proyecto tiene licencia e incluye verificaciones de CI, calificación de CodeFactor, insignias de descargas de npm y Docker, y enlaces de donación.