freyr-js

Freyr est un outil en ligne de commande pour télécharger des morceaux de musique depuis des services de streaming. À partir d'une URL ou d'un URI court de Spotify, Apple Music ou Deezer, il extrait les métadonnées du morceau (titre, artiste, album, numéro de piste/disque, date de sortie, ISRC, label, copyright, pochette et plus), puis interroge des sources audio telles que YouTube Music pour trouver l'audio correspondant, télécharge le fichier brut, l'encode en Apple AAC (.m4a) à un débit configurable (96–320kbps, 320k par défaut), intègre les métadonnées et la pochette d'album, et organise la sortie dans une structure de répertoires ARTIST/ALBUM/TRACK. Les types de requêtes pris en charge incluent les morceaux, les albums, les artistes et les playlists. Les téléchargements par lots sont possibles en passant plusieurs requêtes en arguments ou via un fichier d'entrée (-i/--input) où chaque ligne est une requête et # marque les commentaires. Une sous-commande urify convertit entre les URL de service et les URI courts compatibles freyr. Les options notables incluent la sélection du débit, les téléchargements de chunks concurrents (-n/--chunks), le nombre de tentatives, le répertoire de sortie personnalisé, la vérification d'autres répertoires pour les morceaux existants (-D), le nommage et la taille de la pochette ou sa désactivation, l'ordre de préférence des sources (youtube, yt_music, avec ! pour exclure), les filtres de métadonnées, le réglage de la concurrence par étape (queries, tracks, trackStage, downloader, encoder, embedder), l'indicateur de lecture sans interruption, le forçage de l'écrasement, la génération de playlists (m3u8) avec des options pour le répertoire, l'ajout, l'échappement et le préfixe de namespace, le code pays du storefront, la désactivation de l'organisation en arborescence, le contrôle du répertoire de cache, la taille du cache mémoire, le délai d'attente réseau, les bascules d'authentification et de lancement du navigateur, les styles de barre de progression, et un chemin explicite vers le binaire AtomicParsley. L'installation est disponible via npm (npm install -g freyr) ou Yarn, depuis les sources, ou via les images Docker officielles (freyrcli/freyrjs) avec une commande docker run documentée et un exemple d'alias. Les prérequis incluent Python >= 3.2, Node.js >= 16 et AtomicParsley >= 20230114. Le README note que YouTube Music doit être disponible dans la région de l'utilisateur car l'audio brut en provient. Le projet est sous licence et inclut des vérifications CI, une notation CodeFactor, des badges de téléchargement npm et Docker, ainsi que des liens de don.