# pytubePP - (Pytube Post Processor)
### A Simple CLI Tool to Download Your Favourite YouTube Videos Effortlessly!
[](https://github.com/neosubhamoy/pytubepp/)
[](https://github.com/neosubhamoy/pytubepp/)
[](https://www.python.org/downloads/)
[](https://github.com/neosubhamoy/pytubepp/)
[](https://github.com/neosubhamoy/pytubepp/)
### **🏷️ Features**
* Auto Post-Process & Merge YouTube DASH Streams
* Supports MP3 Download (with Embeded Thumbnail and Tags)
* Smart Stream Selection
* Highly Configurable and Many More 😉
### **🧩 Dependencies**
* [pytube](https://pypi.org/project/pytube/)
* [FFmpeg (Not Pre-Included)](https://ffmpeg.org/)
* [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**
You can install pytubePP in your system via PIP by simply running the below command
```terminal
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`<br>
Windows (using Chocolatey): `choco install ffmpeg`<br>
MacOS (using Homebrew): `brew install ffmpeg`<br>
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:
```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
```
* 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` `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` `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**
<br></br>
****
An Open Sourced Project - Developed with ❤️ by **Subhamoy**
Raw data
{
"_id": null,
"home_page": "https://github.com/neosubhamoy/pytubepp",
"name": "pytubepp",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "youtube,download,video,pytube,cli",
"author": "Subhamoy Biswas",
"author_email": "hey@neosubhamoy.com",
"download_url": "https://files.pythonhosted.org/packages/f2/4f/36658cd4b6f77281705693b4c8bab3a360ddb3981df6c539b6beea3ce164/pytubepp-1.0.1.tar.gz",
"platform": null,
"description": "# pytubePP - (Pytube Post Processor)\n\n### A Simple CLI Tool to Download Your Favourite YouTube Videos Effortlessly!\n\n[](https://github.com/neosubhamoy/pytubepp/)\n[](https://github.com/neosubhamoy/pytubepp/)\n[](https://www.python.org/downloads/)\n[](https://github.com/neosubhamoy/pytubepp/)\n[](https://github.com/neosubhamoy/pytubepp/)\n\n\n### **\ud83c\udff7\ufe0f Features**\n* Auto Post-Process & Merge YouTube DASH Streams\n* Supports MP3 Download (with Embeded Thumbnail and Tags)\n* Smart Stream Selection\n* Highly Configurable and Many More \ud83d\ude09\n\n### **\ud83e\udde9 Dependencies**\n* [pytube](https://pypi.org/project/pytube/)\n* [FFmpeg (Not Pre-Included)](https://ffmpeg.org/)\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**\nYou can install pytubePP in your system via PIP by simply running the below command\n\n```terminal\npip install pytubepp\n```\n**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)**\n\n**>> Install FFmpeg (If you haven't already!)**\n\nLinux (Ubuntu): `apt install ffmpeg`<br>\nWindows (using Chocolatey): `choco install ffmpeg`<br>\nMacOS (using Homebrew): `brew install ffmpeg`<br>\nAndroid (using Termux): `pkg install ffmpeg`\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* 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` `mp3` (Pass any one of them) | Your chosen Default Stream via `-ds` flag |\n| -i | Shows the video information like: Title, Author, Views, Available Download Streams | NO | YES | No parameters | No default |\n| -ds | Set default download stream | YES | NO | `144p` `240p` `360p` `480p` `720p` `1080p` `1440p` `2160p` `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 `Pytube 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.0.1",
"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": "21440f154dfea3b2b01bc5f0d3a7a0d13c54315c26c18f01454d7344cf6046e9",
"md5": "f440992ca6e8fef03e050b7c51231531",
"sha256": "a795c8d918718b869a8acf5ce7fa90a102f62000f6d72043aeefa6fac347957b"
},
"downloads": -1,
"filename": "pytubepp-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f440992ca6e8fef03e050b7c51231531",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9799,
"upload_time": "2024-02-19T16:44:39",
"upload_time_iso_8601": "2024-02-19T16:44:39.860943Z",
"url": "https://files.pythonhosted.org/packages/21/44/0f154dfea3b2b01bc5f0d3a7a0d13c54315c26c18f01454d7344cf6046e9/pytubepp-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f24f36658cd4b6f77281705693b4c8bab3a360ddb3981df6c539b6beea3ce164",
"md5": "4ea3fb7d84ff83d1d1331e9b7eed3056",
"sha256": "7dc3098e9f2581b3c6156efe9865a76d7b763cee75f06b0d6cf422eb5aca9b58"
},
"downloads": -1,
"filename": "pytubepp-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "4ea3fb7d84ff83d1d1331e9b7eed3056",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11544,
"upload_time": "2024-02-19T16:44:41",
"upload_time_iso_8601": "2024-02-19T16:44:41.238550Z",
"url": "https://files.pythonhosted.org/packages/f2/4f/36658cd4b6f77281705693b4c8bab3a360ddb3981df6c539b6beea3ce164/pytubepp-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-19 16:44:41",
"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"
}
JSON
