YouTube Music Downloader

Prerequisites   |   Setup   |   Usage   |   Change Defaults   |   Acknowledgements   

Prerequisites

• Python 3.x
• ffmpeg

Setup

Linux

Available in AUR here

yay -S ytmdl

NOTE: Please install itunespy manually using either pip or using the setup.py because it's not available in AUR at the moment.

Available in PyPi here

pip install ytmdl

Usage

usage: ytmdl [-h] [-q] [--choice CHOICE] [--artist ARTIST] [--album ALBUM]
             [--version] [--url URL] [--disable-metaadd] [-s] [--list LIST]
             [--nolocal]
             SONG_NAME [SONG_NAME ...]

positional arguments:
  SONG_NAME          Name of the song to download.

optional arguments:
  -h, --help         show this help message and exit
  -q, --quiet        Don't ask the user to select songs if more than one
                     search result. The first result in each case will be
                     considered.
  --choice CHOICE    The choice that the user wants to go for. Usefull to pass
                     along with --quiet. Choices start at 1
  --artist ARTIST    Name of the artist
  --album ALBUM      Name of the album.
  --version          show the program version number and exit
  --url URL          Youtube song link.
  --disable-metaadd  Disable addition of passed artist and album keyword to
                     the youtube search in order to get a more accurate
                     result. (Default: false)
  -s, --setup        Setup the config file
  --list LIST        Download list of songs. The list should have one song
                     name in every line.
  --nolocal          Dont search locally for the song before downloading.

Change Defaults

The defaults can be changed by editing the config file in ytmdl folder in your .config folder

Supported options to change are:

Name
SONG_DIR	Directory to save the songs in after editing
SONG_QUALITY	Quality of the song

SONG_DIR also takes values that are extracted from the song

Example format is /your/desired/path$Album->Artist->Title to save in the following way

|--your
    |--desired
           |--path
                |--Album
                        |--Artist
                                |--Title
                                    |--Song.mp3

Adding any tag at the end of the SONG_DIR between [] will be considerd the name of the song.

Example format is /your/desired/path$Album->Artist->[Title] to save in the following way

|--your
    |--desired
        |--path
            |--Album
                |--Artist
                    |--Title.mp3

Supported options are:

Name
Artist	Artist Of the Song
Album	Album Of the Song
Title	Title Of the Song
Genre	Genre Of the Song
TrackNumber	TrackNumber Of the Song
ReleaseDate	ReleaseDate Of the Song

Acknowledgements

• Inspired from https://github.com/tterb/yt2mp3

• Thanks to the developers of youtube-dl, itunespy, mutagen, colorama and Python.

• Thanks to itunes and gaana for their awesome API's.

• Thanks to Nishan Pantha for search logic.

• Thanks to Biswaroop for testing in windows.