Download YouTube Music songs/albums/playlists with tags from YouTube Music in 256kbps AAC/128kbps Opus/128kbps AAC.
While this project uses yt-dlp under the hood, it has the advantage of utilizing YouTube Music's API to get songs metadata. This includes information such as track number, square cover, lyrics, year, etc.
- Install Python 3.8 or higher
- Install gytmdl with pip
pip install gytmdl - Add FFmpeg to PATH or specify the location using the command line arguments or the config file (see Configuration)
Download a song:
gytmdl "https://music.youtube.com/watch?v=3BFTio5296w"
Download an album:
gytmdl "https://music.youtube.com/playlist?list=OLAK5uy_lvpL_Gr_aVEq-LaivwJaSK5EbFd4HeamM"
gytmdl can be configured using the command line arguments or the config file. The config file is created automatically when you run gytmdl for the first time at ~/.gytmdl/config.json on Linux and %USERPROFILE%\.gytmdl\config.json on Windows. Config file values can be overridden using command line arguments.
| Command line argument | Config file key | Description | Default value |
|---|---|---|---|
-f, --final-path |
final_path |
Path where the downloaded files will be saved. | ./YouTube Music |
-t, --temp-path |
temp_path |
Path where the temporary files will be saved. | ./temp |
-c, --cookies-location |
cookies_location |
Location of the cookies file. By setting a cookies file, you can download age restricted tracks, private playlists and songs in 256kbps AAC if you are a premium user. You can export your cookies by using the following Google Chrome extension on YouTube Music website: https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif. | null |
--ffmpeg-location |
ffmpeg_location |
Location of the FFmpeg binary. | ffmpeg |
--config-location |
- | Location of the config file. | <home>/.gytmdl/config.json |
-i, --itag |
itag |
Itag (audio quality). Can be 141 (256kbps AAC), 251 (128kbps Opus) or 140 (128kbps AAC). |
140 |
--cover-size |
cover_size |
Size of the cover. Can be any number between 0 and 16383. 0 gets the highest resolution available. |
1200 |
--cover-format |
cover_format |
Format of the cover. Can be jpg or png. |
jpg |
--cover-quality |
cover_quality |
JPEG quality of the cover. Can be any number between 0 and 100. |
94 |
--num-threads |
num_threads |
Specify number of threads for parallel downloads 1 to 10. |
1 |
--final-path-structure |
final_path_structure |
Structure of the final path as a format string. Possible variables are album, album_artist, artist, media_type, rating, title, track, track_total and year. |
{album_artist}/{album}/{track:02d} {title} |
-e, --exclude-tags |
exclude_tags |
List of tags to exclude from file tagging separated by commas. Possible variables are album, album_artist, artist, comment, cover, lyrics, media_type, rating, release_date, title, track and track_total. |
null |
--truncate |
truncate |
Maximum length of the file/folder names. | 40 |
-l, --log-level |
log_level |
Log level. Can be DEBUG, INFO, WARNING, ERROR or CRITICAL. |
INFO |
-s, --save-cover |
save_cover |
Save cover as a separate file. | false |
-o, --overwrite |
overwrite |
Overwrite existing files. | false |
-p. --print-exceptions |
print_exceptions |
Print exceptions. | false |
-u, --url-txt |
- | Read URLs as location of text files containing URLs. | false |
-n, --no-config-file |
- | Don't use the config file. | false |