pytubepp


Namepytubepp JSON
Version 1.1.2 PyPI version JSON
download
home_pageNone
SummaryA Simple CLI Tool to Download Your Favorite YouTube Videos Effortlessly!
upload_time2024-10-22 11:17:57
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
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"
}
        
Elapsed time: 0.64864s