Download YouTube videos fast, directly from the command line

youtube, media, video, audio, download, convert, command, line, cli, download-youtube-videos, downloader, pypi, python, youtube-downloader
pip install mediakit==0.7.2



YouTube Download YouTube videos fast, directly from the command line

Latest version on PyPI Monthly downloads Number of contributors License

Features   |    Installation   |    How to use   |    API Reference   |    Development experiences

Mediakit is a command line tool to download videos from YouTube.

Downloading with Mediakit


  • Quickly download YouTube videos with a single command on your terminal
  • Select specific download formats (video, audio and video-only) if you want to, with resolutions as high as 4K 😎


To install Mediakit, you need Python 3.6+ and pip already installed on your computer. Then, run:

pip install mediakit

How to use

You can download a video with Mediakit by running:

mediakit <video_url> [<output_path>]
  • video_url: the URL of the video to download (e.g.

    As URL's may have special characters, it is recommended that you wrap the URL in double quotes ("") to ensure that it will be recognized properly.

  • output_path: optional destination to where to save the downloads. If not provided, this will default to the current directory.

    You can also provide a custom name for the downloaded file. To do that, include it in the output path (e.g. path/to/folder/video.mp4).

After running this command, an interactive CLI will guide you through the download process.

Examples of use:

  • Download to the current directory

    mediakit ""
  • Download to ~/Videos

    mediakit "" ~/Videos
  • Download to ~/Videos with name song.mp4

    mediakit "" ~/Videos/song.mp4

Selecting specific download formats

By default, Mediakit will download the specified video with the highest available resolution. However, you can select specific download formats with the flag --formats (or its shorthand -f), followed by one or more desired formats:

mediakit <video_url> [<output_path>] [-f | --formats]

You can also download as audio (mp3) or as video only (without audio) by using the format options audio and videoonly, respectively. If no resolution is provided with these options, Mediakit will download the media with highest quality, although you can select a specific resolution by adding it right after the option used (e.g. -f audio 128kbps). Check the examples bellow for more use details.

If a resolution is not available for the video, the download will fall back to the closest available resolution lower than the one specified.

Examples of use:

  • Download with resolution of 1080p

    mediakit "" -f 1080p
  • Download with resolution of 4K (2160p)

    mediakit "" -f 4K
  • Download multiple resolutions at once (each resolution will be downloaded in a different file)

    mediakit "" -f 1080p 720p
  • Download with the highest resolution available (same result as not using the flag -f)

    mediakit "" -f max
  • Download as audio (mp3)

    mediakit "" -f audio
  • Download multiple formats and resolutions at once (each resolution will be downloaded in a different file)

    mediakit "" -f 1080p audio videoonly 720p
    # download video with 1080p, audio with highest definition available and video-only (without audio) with 720p

Downloading multiple videos

Downloading from playlists

By providing a playlist URL, Mediakit will automatically download all videos in it.

mediakit <playlist_url> [<output_path>]

Make sure the playlist is marked as public, otherwise Mediakit won't be able to access it!

You can also use other options with this command, such as specify which formats and definitions you want your downloads to be.

Using a batch file

With the option -b (or its longhand --batch), you can download multiple videos sequentially by providing a batch file (a text file containing one or more video URL's, each one in a separate line):

mediakit [-b | --batch] <batch_file>

By running this, Mediakit will read all URL's in the provided file and download them sequentially.

You can also use other options along with --batch, similarly to downloading from playlists.

Examples of use:

Using a batch file called urls.txt as an example:

# contents of `urls.txt`
  • Download URL's in urls.txt with the highest available resolution

    mediakit -b urls.txt
  • Download URL's in urls.txt as audio (mp3)

    mediakit -b urls.txt -f audio

API Reference

Mediakit currently supports the following command options:

Option Description Example
-h, --help Show help mediakit -h
-v, --version Show the currently installed version mediakit -v
-y, --yes Answer "yes" to all questions beforehand mediakit https://... -y
-b <batch_file>,
--batch <batch_file>
Download videos from URL's stored in a batch file mediakit -b urls.txt
-nc, --no-colors Disable the colors of the interface mediakit https://... -nc
-f <formats>,
--formats <formats>
Specify which formats you want to download mediakit https://... -f audio
-p <maximum downloads in parallel>,
--formats <maximum downloads in parallel>
Set a limit to downloads in parallel mediakit https://... -f audio

Development experiences

All experiences and learning acquired during the development of Mediakit are detailed in Development experiences and learning. Check it out if you want to know more about what were the motivations to build this project, how it was developed and what were the main challenges and experiences.

Made by Diego Aquino 😎. Connect with me!