Skip to main content

A Simple CLI Tool to Download Your Favorite YouTube Videos Effortlessly!

Project description

PytubePP - (Pytube Post Processor)

A Simple CLI Tool to Download Your Favourite YouTube Videos Effortlessly!

status verion python builds PRs

😀 GOOD NEWS: If you are Windows(10/11) user and don't want to bother remembering PytubePP Commands! (You are not familier with Command Line Tools). We recently released a Browser Extension that can auto detect YouTube Videos and You can download the Video in one click directly from the browser using PytubePP CLI. Install PytubePP Helper app in your Computer and add PytubePP Extension in your Browser to get started.

🏷️ Features

  • Auto Post-Process & Merge YouTube DASH Streams
  • Supports upto 8K 60fps HDR Stream Download
  • Supports MP3 Download (with Embeded Thumbnail and Tags)
  • Smart Stream Selection
  • Highly Configurable and Many More 😉

🧩 Dependencies

🛠️ Installation

You can install pytubePP in your system via PIP by simply running the below command

pip install pytubepp

IMPORTANT: Before installing pytubePP make sure FFmpeg is installed in your system and accesable via your cli interface (FFmpeg is Must Required as some of the core features of pytubePP relies on FFmpeg, but due to security reasons we can not ship it with the module)

>> Install FFmpeg (If you haven't already!)

Linux (Ubuntu): apt install ffmpeg
Windows (10/11): winget install ffmpeg
MacOS (using Homebrew): brew install ffmpeg
Android (using Termux): pkg install ffmpeg

📌 Commands and Flags

Using pytubePP is as simple as just supplying it only the YouTube video url as argument! ** Before Starting Please NOTE: pytubePP follows a simple rule - "Use the Default Download Configuration if No Flags are Passed"

  • To download a video in maximum available resolution the command will look like:
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo"
  • To download the video in a specific resolution (suppose 480p) the command will be:
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo" -s 480p
  • To download the video in audio-only MP3 format the command will be:
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo" -s mp3
  • To fetch the video information the command will be:
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo" -i
  • To cancel/stop an ongoing download press CTRL + C on keyboard (it is recommended to run the -ct flag once after canceling an ongoing download).
  • List of all available flags are given below:
Flag Usage Requires Parameter Requires URL Parameters Default
-s Choose preferred download stream YES YES 144 144p 240 240p 360 360p 480 480p 720 720p hd 1080 1080p fhd 1440 1440p 2k 2160 2160p 4k 4320 4320p 8k mp3 (Pass any one of them) Your chosen Default Stream via -ds flag
-i Shows the video information like: Title, Author, Views, Available Download Streams NO YES No parameters No default
-ds Set default download stream YES NO 144p 240p 360p 480p 720p 1080p 1440p 2160p 4320p mp3 max (Pass any one of them) max
-df Set custom download folder path YES NO Use the full path excluding the last trailing slash within double quotes eg(in Linux): "/path/to/folder" (Make sure the folder path you enterted is already created and accessable) Within Pytube Downloads folder in your System's Downloads folder
-r Reset to default configuration (Download Folder, Default Stream) NO NO No parameters No default
-sc Show all current user configurations NO NO No parameters No default
-ct Clear temporary files (audio, video, thumbnail) of the failed, incomplete downloads NO NO No parameters No default

⭕ Noticed any Bugs? or Want to give me some suggetions? always feel free to open an issue...!!

📝 License & Usage

pytubePP - (Pytube Post Processor) is a Fully Open Sourced Project licensed under MIT License. Anyone can view, modify, use (personal and commercial) or distribute it's sources without any attribution and extra permissions.

🌟 Liked this project? Please consider giving it a star to show me your appreciation


An Open Sourced Project - Developed with ❤️ by Subhamoy

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

pytubepp-1.0.5.tar.gz (13.2 kB view details)

Uploaded Source

Built Distribution

pytubepp-1.0.5-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

File details

Details for the file pytubepp-1.0.5.tar.gz.

File metadata

  • Download URL: pytubepp-1.0.5.tar.gz
  • Upload date:
  • Size: 13.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for pytubepp-1.0.5.tar.gz
Algorithm Hash digest
SHA256 f110512000d90da2d2f08a7535aa510d2c294df5a218f3ecceafbbb07df16a71
MD5 8198cb485ce20e5fd7bcbff44ed3a360
BLAKE2b-256 fb1a2aeca0e681a153b88e76ef35f96791605a31b40317af7007122495c2845a

See more details on using hashes here.

File details

Details for the file pytubepp-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: pytubepp-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 11.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for pytubepp-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 72251aa7fc55736caa2a784b694f608fa066d593e78d09fe5d353c531c7cf2b5
MD5 c208f8a6e10a73385c1cc58955122944
BLAKE2b-256 5ac9e40468191a2fbe7248c39aa20f743339e177d91c43434c3985f91a80ca5a

See more details on using hashes here.

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