Skip to main content

A command line tool to easily download song instrumentals from Youtube.

Project description


A command line tool to download a song's instrumental from Youtube.


If you don't have pip, install it here:

First, you need to install ffprobe/ ffmpeg:

  1. Download the build for your OS
  2. Extract the program folder from the download
  3. Add the program folder to the system PATH:

Then, use pip3 to install:

pip3 install instrumental-dl


Instrumental-downloader was created as a command-line tool used to download a list of instrumentals based on just the song name.(and sometimes the artist is needed to identify the song) This tool is based off of youtube-dl, a tool used to download youtube videos from their url. The Python interpreter version 3.6+ is needed for this program. FFprobe/ ffmpeg needs to be installed in the PATH, as that is the program used to download instrumentals as mp3 files.

instrumental-dl -f FILE_NAME
instrumental-dl -s "SONG_NAMES" ["SONG_NAMES"...]
  (with -s the song name needs to be in quotations
  if it contains any spaces)


-h, --help              Print the help text and exit
--version               Print the current version and exit

-f, --file             Open this file and download each song
                        name in the file as an instrumental
                        (each song name should be on a seperate line)
-s, --songs            Download each song name as an instrumental
                        (can be multiple song names)

-v, --verbose           Verbose: Print out each download and conversion.
                        Also gives detailed time elapsed description.
-o, --output            Change the directory where the songs are
                        downloaded to.


- Download album cover for song to use as file icon
- Check for wrong instrumental downloads
- New file renaming system

- GUI Application
    - Add gui interaction for Windows, MacOS, and Linux

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 instrumental-dl, version 0.6.5
Filename, size File type Python version Upload date Hashes
Filename, size instrumental_dl-0.6.5-py3-none-any.whl (12.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size instrumental-dl-0.6.5.tar.gz (8.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page