Skip to main content

Youtube Music Downloader

Project description

YouTube Music Downloader

ytmdl in action

PyPi Version PyPI Python Versions License


  1. Prerequisites
  2. Important
  3. Setup
  4. Usage
  5. Change Defaults
  6. Acknowledgements


  • Python 3.x
  • ffmpeg


After every update run the following.

ytmdl -s



Run the following commands from you terminal

# Install ffmpeg
sudo apt-get install ffmpeg

# Install ytmdl
sudo pip install ytmdl

# Setup the config file
ytmdl -s


  • Download the repo and extract it.

  • Run the following in cmd

   # Copy the config
   python -s
  • Download ffmpeg from here.

  • Extract.

  • Copy the three files in bin to C:\users\{username}\appdata\local\programs\python\python36\scripts\


usage: ytmdl [-h] [-q] [--version] [--url URL] [-s] [-l LIST] [--nolocal]

positional arguments:
  SONG_NAME             Name of the song to download.

optional arguments:
  -h, --help            show this help message and exit
  -q, --quiet           Dont ask the user to select songs if more than one
                        search result. The first result in each case will be
  --version             show the program version number and exit
  --url URL             Youtube song link.
  -s, --setup           Setup the config file
  -l LIST, --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.

In case of windows, use python instead of ytmdl above

Change Defaults

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

Supported options to change are:

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

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

Supported options are:

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


  • Inspired from

  • 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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ytmdl, version 2019.4.23.2
Filename, size File type Python version Upload date Hashes
Filename, size ytmdl-2019.4.23.2.tar.gz (17.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page