Skip to main content

Awesome CLI to download YouTube videos (as video or audio)/shorts/playlists from the terminal

Project description

📹 YouTube Downloader CLI

Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐

Version Downloads

[!NOTE] Have a new feature? Please don't hesitate to tell me!

Pyutube

📓 Description

This command-line tool downloads YouTube videos from the Terminal, written under Pytube, and offers a user-friendly interface.

it is cross-platform (Windows, Mac, Linux) and can be used in any terminal.

🤔 why pyutube?

While other tools offer many features and configurability, pyutube simplifies the process, with no need to dive into complex configurations and documentation, such as identifying specific options for downloading audio-only, or how to download a specific resolution, but on pyutube just paste the URL and that's it, it will guide you through the process 🔥.

🛠️ Installation

it is easy to install Pyutube, make sure that you have Python installed. To check if you have it installed, type python --version in your terminal. You should see something like Python 3. x otherwise, download and install it from Python.

after that, you can install it with the following command:

pip install pyutube

📈 Upgrade

All the latest updates will be posted on GitHub, you can also upgrade the tool via PyPI with this command:

pip install --upgrade pyutube

Then you can use it in your Terminal 🥳.

🦸 Quick Start

Pyutube is very easy to use, here are examples of its uses:

pyutube YOUTUBE_LINK [PATH]

[!NOTE] > [PATH] is an optional input, the default value is the terminal path where the CLI is running (the current working directory in your terminal).

👨‍💻 Usage

Arguments

Arguments Description
URL The URL of the YouTube video. This argument is [Required].
PATH The path to save the video. Defaults to the current working directory. [Optional]

Options

Option Description
-v or --version Show the version number.
-a or --audio Download only audio immediately without asking (video or audio).
-f or --footage Download only video immediately without asking (video or audio).

🕵️‍♂️ Examples

- Show version:

pyutube -v

- Download playlists:

  1. pyutube <YOUTUBE_PLAYLIST_LINK | PLAYLIST_ID> [the_download_path*]

[!NOTE] Don't forget, the path is optional.

  1. Then choose the format of the download, video or audio.
  2. Choose the resolution if it is a video you want to download, otherwise, choose audio and it will download it all immediately 🔥.

[!NOTE] It will check all resolutions available in the first video in the playlist, then it will download all of them in the same resolution 👍.

- Download shorts, videos, or audio:

  1. pyutube <YOUTUBE_LINK | VIDEO_ID | SHORT_LINK> [the_download_path*]

[!NOTE] Don't forget, the path is optional.

  1. Then choose the format of the download, video or audio.
  2. Choose the resolution if it is a video you want to download, otherwise, choose audio and it will download it immediately 🔥.
pyutube cMPnY7EuZvo
pyutube youtu.be/cMPnY7EuZvo
pyutube https://youtube.com/watch?v=cMPnY7EuZvo

- Download audio immediately:

  1. pyutube <YOUTUBE_LINK | VIDEO_ID | SHORT_LINK> [the_download_path*] -a
pyutube cMPnY7EuZvo -a

or

pyutube -a youtu.be/cMPnY7EuZvo

and that's it 🎉.

- Download videos immediately:

  1. pyutube <YOUTUBE_LINK | VIDEO_ID | SHORT_LINK> [the_download_path*] -f
  2. Choose the resolution.
pyutube cMPnY7EuZvo -f

or

pyutube -f youtu.be/cMPnY7EuZvo

see the video and relax 🎉.

📸 Screenshots

Download video with specify the save location

Download video with specify the save location

Chose what type you want to download

Chose what type you want to download

Chose what what resolution you want to download(if the type is video)

Chose what resolution you want to download

If you download a playlist, you can choose what video you want to download, or even all of them

If you download a playlist, you can choose what video you want to download, or even all of them

Do not know how to use it? just type pyutube --help

image5

🥰 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you want to change. please follow the contributing guidelines

📎 License

This project is licensed under the MIT License.

Project details


Download files

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

Source Distribution

pyutube-1.2.5.tar.gz (17.0 kB view hashes)

Uploaded Source

Built Distribution

pyutube-1.2.5-py3-none-any.whl (16.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page