À propos du projet

Tidal-Media-Downloader est une application en ligne de commande, distribuée sous forme de paquet Python tidal-dl, qui télécharge des médias depuis le service de streaming Tidal. Le README indique qu'il prend en charge deux versions : tidal-dl (CLI, contenue dans ce dépôt) et tidal-gui (un dépôt GUI séparé, Tidal-Media-Downloader-PRO), et note que les versions ici ne sont pas la dernière version GUI. L'installation se fait via pip : `pip3 install tidal-dl --upgrade`. Les modes d'utilisation documentés sont : exécuter `tidal-dl` pour une interface interactive, `tidal-dl -h` pour l'aide, `tidal-dl -l "<url>"` pour télécharger un lien, et `tidal-dl -g` pour afficher une simple GUI. Les utilisateurs Windows sont dirigés vers le projet GUI tidal-pro. Des versions nocturnes sont disponibles via le workflow d'intégration continue du projet. Les fonctionnalités documentées incluent le téléchargement d'albums, pistes, vidéos, playlists et albums d'artistes ; l'ajout de métadonnées aux chansons ; et la sélection de la résolution vidéo et de la qualité des pistes. Le README inclut des captures d'écran de l'interface utilisateur. Une partie notable de la documentation est le système configurable de nommage/balisage. Des ensembles de balises séparés sont listés pour les albums, pistes et vidéos, avec des exemples de valeurs. Les balises d'album incluent {ArtistName}, {AlbumArtistName}, {Flag} (Master/Dolby Atmos/Explicit), {AlbumID}, {AlbumYear}, {AlbumTitle}, {AudioQuality}, {DurationSeconds}, {Duration}, {NumberOfTracks}, {NumberOfVideos}, {NumberOfVolumes}, {ReleaseDate}, {RecordType} et {None}. Les balises de piste incluent {TrackNumber}, {ArtistName}, {ArtistsName}, {TrackTitle}, {ExplicitFlag}, {AlbumYear}, {AlbumTitle}, {AudioQuality}, {DurationSeconds}, {Duration} et {TrackID}. Les balises vidéo incluent {VideoNumber}, {ArtistName}, {ArtistsName}, {VideoTitle}, {ExplicitFlag}, {VideoYear} et {TrackID}. Le projet crédite des bibliothèques et références incluant aigpy, python-tidal, redsea et le wiki Tidal. Les instructions de développement couvrent la désinstallation du paquet pip, l'installation des exigences et l'exécution de setup.py install. La clause de non-responsabilité du README indique que l'outil est destiné à un usage privé uniquement, nécessite un abonnement Tidal-HIFI, ne doit pas être utilisé pour distribuer ou pirater de la musique, et peut être illégal dans certains pays. Ce sont les conditions énoncées par l'auteur ; les utilisateurs doivent vérifier les exigences de licence et légales dans leur propre juridiction. Le dépôt est sous licence selon les termes de son fichier LICENSE.