Name | pytubepp JSON |
Version |
1.1.2
JSON |
| download |
home_page | None |
Summary | A Simple CLI Tool to Download Your Favorite YouTube Videos Effortlessly! |
upload_time | 2024-10-22 11:17:57 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.8 |
license | MIT |
keywords |
youtube
download
video
pytube
cli
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# PytubePP - (Pytube Post Processor)
### A Simple CLI Tool to Download Your Favourite YouTube Videos Effortlessly!
[![status](https://img.shields.io/badge/status-active-brightgreen.svg?style=flat)](https://github.com/neosubhamoy/pytubepp/)
[![PypiDownloads](https://img.shields.io/pypi/dm/pytubepp?color=brightgreen)](https://pypi.org/project/pytubepp/)
[![PypiVersion](https://img.shields.io/pypi/v/pytubepp?color=yellow)](https://pypi.org/project/pytubepp/)
[![python](https://img.shields.io/badge/python-v3.13-blue?logo=python&style=flat)](https://www.python.org/downloads/)
[![builds](https://img.shields.io/badge/builds-passing-brightgreen.svg?style=flat)](https://github.com/neosubhamoy/pytubepp/)
[![PRs](https://img.shields.io/badge/PRs-welcome-blue.svg?style=flat)](https://github.com/neosubhamoy/pytubepp/)
😀 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](https://github.com/neosubhamoy/pytubepp-helper) app in your System and add [PytubePP Extension](https://github.com/neosubhamoy/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 😉
### **📎 Pre-Requirements**
* [Python](https://www.python.org/downloads/) (>=3.8)
* [FFmpeg](https://ffmpeg.org/)
### **🧩 Python Dependencies**
* [pytubefix](https://pypi.org/project/pytubefix/)
* [ffmpy](https://pypi.org/project/ffmpy/)
* [mutagen](https://pypi.org/project/mutagen/)
* [tabulate](https://pypi.org/project/tabulate/)
* [tqdm](https://pypi.org/project/tqdm/)
* [appdirs](https://pypi.org/project/appdirs/)
* [requests](https://pypi.org/project/requests/)
* [setuptools](https://pypi.org/project/setuptools/)
### **🛠️ Installation**
1. Install Python and PIP
- Linux (Debian): Python is pre-installed install PIP using `sudo apt install python3-pip`<br>
- Linux (Fedora): Python is pre-installed install PIP using `sudo dnf install python3-pip`<br>
- Linux (Arch): Python is pre-installed install PIP using `sudo pacman -S python-pip`<br>
- Windows (10/11): `winget install Python.Python.3.13`<br>
- MacOS (using Homebrew): `brew install python`<br>
- Android (using Termux): `pkg install python`
2. Install FFmpeg
- Linux (Debian): `sudo apt install ffmpeg`<br>
- Linux (Fedora): `sudo dnf install ffmpeg-free`<br>
- Linux (Arch): `sudo pacman -S ffmpeg`<br>
- Windows (10/11): `winget install ffmpeg`<br>
- MacOS (using Homebrew): `brew install ffmpeg`<br>
- Android (using Termux): `pkg install ffmpeg`
3. Install PytubePP (using PIP)
```terminal
pip install pytubepp
```
**NOTE: Always make sure 'PytubePP' and 'Pytubefix' is on the latest version to avoid issues (update them at least once a week) (Use the command below to update)**
```
pip install pytubefix pytubepp --upgrade
```
### **📌 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:
```terminal
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo"
```
* To download the video in a specific resolution (suppose 480p) the command will be:
```terminal
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo" -s 480p
```
* To download the video in audio-only MP3 format the command will be:
```terminal
pytubepp "https://youtube.com/watch?v=2lAe1cqCOXo" -s mp3
```
* To fetch the video information the command will be:
```terminal
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, Publication Date, Duration, Available Download Streams | NO | YES | No parameters | No default |
| -ri | Shows the video information in raw json format | NO | YES | No parameters | No default |
| -jp | Shows raw json output in prettified view (with indentation: 4) (primarily used with -ri flag)| 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 `PytubePP 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**
<br></br>
****
An Open Sourced Project - Developed with ❤️ by **Subhamoy**
Raw data
{
"_id": null,
"home_page": null,
"name": "pytubepp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "youtube, download, video, pytube, cli",
"author": null,
"author_email": "Subhamoy Biswas <hey@neosubhamoy.com>",
"download_url": "https://files.pythonhosted.org/packages/57/32/7014890b71666a2a50130e17adc0c9c7e2f43871448beb58ba8e1558bc77/pytubepp-1.1.2.tar.gz",
"platform": null,
"description": "# PytubePP - (Pytube Post Processor)\n\n### A Simple CLI Tool to Download Your Favourite YouTube Videos Effortlessly!\n\n[![status](https://img.shields.io/badge/status-active-brightgreen.svg?style=flat)](https://github.com/neosubhamoy/pytubepp/)\n[![PypiDownloads](https://img.shields.io/pypi/dm/pytubepp?color=brightgreen)](https://pypi.org/project/pytubepp/)\n[![PypiVersion](https://img.shields.io/pypi/v/pytubepp?color=yellow)](https://pypi.org/project/pytubepp/)\n[![python](https://img.shields.io/badge/python-v3.13-blue?logo=python&style=flat)](https://www.python.org/downloads/)\n[![builds](https://img.shields.io/badge/builds-passing-brightgreen.svg?style=flat)](https://github.com/neosubhamoy/pytubepp/)\n[![PRs](https://img.shields.io/badge/PRs-welcome-blue.svg?style=flat)](https://github.com/neosubhamoy/pytubepp/)\n\n\ud83d\ude00 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](https://github.com/neosubhamoy/pytubepp-helper) app in your System and add [PytubePP Extension](https://github.com/neosubhamoy/pytubepp-extension) in your Browser to get started.\n\n### **\ud83c\udff7\ufe0f Features**\n* Auto Post-Process & Merge YouTube DASH Streams\n* Supports upto 8K 60fps HDR Stream Download\n* Supports MP3 Download (with Embeded Thumbnail and Tags)\n* Smart Stream Selection\n* Highly Configurable and Many More \ud83d\ude09\n\n### **\ud83d\udcce Pre-Requirements**\n* [Python](https://www.python.org/downloads/) (>=3.8)\n* [FFmpeg](https://ffmpeg.org/)\n\n### **\ud83e\udde9 Python Dependencies**\n* [pytubefix](https://pypi.org/project/pytubefix/)\n* [ffmpy](https://pypi.org/project/ffmpy/)\n* [mutagen](https://pypi.org/project/mutagen/)\n* [tabulate](https://pypi.org/project/tabulate/)\n* [tqdm](https://pypi.org/project/tqdm/)\n* [appdirs](https://pypi.org/project/appdirs/)\n* [requests](https://pypi.org/project/requests/)\n* [setuptools](https://pypi.org/project/setuptools/)\n\n### **\ud83d\udee0\ufe0f Installation**\n1. Install Python and PIP\n - Linux (Debian): Python is pre-installed install PIP using `sudo apt install python3-pip`<br>\n - Linux (Fedora): Python is pre-installed install PIP using `sudo dnf install python3-pip`<br>\n - Linux (Arch): Python is pre-installed install PIP using `sudo pacman -S python-pip`<br>\n - Windows (10/11): `winget install Python.Python.3.13`<br>\n - MacOS (using Homebrew): `brew install python`<br>\n - Android (using Termux): `pkg install python`\n2. Install FFmpeg \n - Linux (Debian): `sudo apt install ffmpeg`<br>\n - Linux (Fedora): `sudo dnf install ffmpeg-free`<br>\n - Linux (Arch): `sudo pacman -S ffmpeg`<br>\n - Windows (10/11): `winget install ffmpeg`<br>\n - MacOS (using Homebrew): `brew install ffmpeg`<br>\n - Android (using Termux): `pkg install ffmpeg`\n3. Install PytubePP (using PIP)\n\n```terminal\npip install pytubepp\n```\n\n**NOTE: Always make sure 'PytubePP' and 'Pytubefix' is on the latest version to avoid issues (update them at least once a week) (Use the command below to update)**\n\n```\npip install pytubefix pytubepp --upgrade\n```\n\n### **\ud83d\udccc Commands and Flags**\nUsing PytubePP is as simple as just supplying it only the YouTube video url as argument!\n** Before Starting Please NOTE: PytubePP follows a simple rule - \"Use the Default Download Configuration if No Flags are Passed\"\n* To download a video in maximum available resolution the command will look like:\n```terminal\npytubepp \"https://youtube.com/watch?v=2lAe1cqCOXo\"\n```\n* To download the video in a specific resolution (suppose 480p) the command will be:\n```terminal\npytubepp \"https://youtube.com/watch?v=2lAe1cqCOXo\" -s 480p\n```\n* To download the video in audio-only MP3 format the command will be:\n```terminal\npytubepp \"https://youtube.com/watch?v=2lAe1cqCOXo\" -s mp3\n```\n* To fetch the video information the command will be:\n```terminal\npytubepp \"https://youtube.com/watch?v=2lAe1cqCOXo\" -i\n```\n* 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).\n* List of all available flags are given below:\n\n| Flag | Usage | Requires Parameter | Requires URL | Parameters | Default |\n| :--- | :--- | :--- | :--- | :--- | :--- |\n| -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 |\n| -i | Shows the video information like: Title, Author, Views, Publication Date, Duration, Available Download Streams | NO | YES | No parameters | No default |\n| -ri | Shows the video information in raw json format | NO | YES | No parameters | No default |\n| -jp | Shows raw json output in prettified view (with indentation: 4) (primarily used with -ri flag)| NO | YES | No parameters | No default |\n| -ds | Set default download stream | YES | NO | `144p` `240p` `360p` `480p` `720p` `1080p` `1440p` `2160p` `4320p` `mp3` `max` (Pass any one of them) | `max` |\n| -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 `PytubePP Downloads` folder in your System's `Downloads` folder |\n| -r | Reset to default configuration (Download Folder, Default Stream) | NO | NO | No parameters | No default |\n| -sc | Show all current user configurations | NO | NO | No parameters | No default |\n| -ct | Clear temporary files (audio, video, thumbnail) of the failed, incomplete downloads | NO | NO | No parameters | No default |\n\n\n\u2b55 Noticed any Bugs? or Want to give me some suggetions? always feel free to open an issue...!!\n\n### \ud83d\udcdd License & Usage\n\nPytubePP - (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.\n\n**\ud83c\udf1f Liked this project? Please consider giving it a star to show me your appreciation**\n<br></br>\n\n****\n\nAn Open Sourced Project - Developed with \u2764\ufe0f by **Subhamoy**\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Simple CLI Tool to Download Your Favorite YouTube Videos Effortlessly!",
"version": "1.1.2",
"project_urls": {
"Bug Reports": "https://github.com/neosubhamoy/pytubepp/issues",
"Homepage": "https://github.com/neosubhamoy/pytubepp"
},
"split_keywords": [
"youtube",
" download",
" video",
" pytube",
" cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "94d0b8eb801f47356921f8c20e6809f727f966951f372850684631ccbb07ae84",
"md5": "9bb9b188b97d0f9c4683927fb6eff2e8",
"sha256": "456a9f23ccb2e0b2f119a5d05629cb283f0466e931d2eb108d81256ee7c58de3"
},
"downloads": -1,
"filename": "pytubepp-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9bb9b188b97d0f9c4683927fb6eff2e8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 13843,
"upload_time": "2024-10-22T11:17:56",
"upload_time_iso_8601": "2024-10-22T11:17:56.267323Z",
"url": "https://files.pythonhosted.org/packages/94/d0/b8eb801f47356921f8c20e6809f727f966951f372850684631ccbb07ae84/pytubepp-1.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "57327014890b71666a2a50130e17adc0c9c7e2f43871448beb58ba8e1558bc77",
"md5": "c7fb134a4b61dbe923d3d7f59e2d3a44",
"sha256": "c8f52fcad823f4f8b2abe5c08cb7f03b3fe286dd1c50a8023873adf3e895f8e8"
},
"downloads": -1,
"filename": "pytubepp-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "c7fb134a4b61dbe923d3d7f59e2d3a44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 15199,
"upload_time": "2024-10-22T11:17:57",
"upload_time_iso_8601": "2024-10-22T11:17:57.632216Z",
"url": "https://files.pythonhosted.org/packages/57/32/7014890b71666a2a50130e17adc0c9c7e2f43871448beb58ba8e1558bc77/pytubepp-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-22 11:17:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "neosubhamoy",
"github_project": "pytubepp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pytubepp"
}