About this project

Tidal-Media-Downloader is a command-line application, distributed as the Python package tidal-dl, that downloads media from the Tidal streaming service. The README states it supports two versions, tidal-dl (CLI, contained in this repository) and tidal-gui (a separate GUI repository, Tidal-Media-Downloader-PRO), and notes that releases here are not the newest GUI version. Installation is via pip: `pip3 install tidal-dl --upgrade`. The documented usage modes are: running `tidal-dl` for an interactive interface, `tidal-dl -h` for help, `tidal-dl -l "<url>"` to download a link, and `tidal-dl -g` to show a simple GUI. Windows users are pointed to the tidal-pro GUI project. Nightly builds are available from the project's continuous integration workflow. Documented features include downloading album, track, video, playlist and artist-albums; adding metadata to songs; and selecting video resolution and track quality. The README includes screenshots of the user interface. A notable part of the documentation is the configurable naming/tag system. Separate tag sets are listed for albums, tracks and videos, with example values. Album tags include {ArtistName}, {AlbumArtistName}, {Flag} (Master/Dolby Atmos/Explicit), {AlbumID}, {AlbumYear}, {AlbumTitle}, {AudioQuality}, {DurationSeconds}, {Duration}, {NumberOfTracks}, {NumberOfVideos}, {NumberOfVolumes}, {ReleaseDate}, {RecordType} and {None}. Track tags include {TrackNumber}, {ArtistName}, {ArtistsName}, {TrackTitle}, {ExplicitFlag}, {AlbumYear}, {AlbumTitle}, {AudioQuality}, {DurationSeconds}, {Duration} and {TrackID}. Video tags include {VideoNumber}, {ArtistName}, {ArtistsName}, {VideoTitle}, {ExplicitFlag}, {VideoYear} and {TrackID}. The project credits libraries and references including aigpy, python-tidal, redsea and the Tidal wiki. Development instructions cover uninstalling the pip package, installing requirements and running setup.py install. The README's disclaimer states the tool is for private use only, requires a Tidal-HIFI subscription, should not be used to distribute or pirate music, and may be illegal in some countries. These are the author's stated conditions; users should verify licensing and legal requirements in their own jurisdiction. The repository is licensed under the terms in its LICENSE file.