<p align="center">
<a href="https://github.com/Simatwa/yt5"><img src="https://img.shields.io/static/v1?logo=github&color=blueviolet&label=Test&message=Pass"/></a>
<a href="LICENSE"><img src="https://img.shields.io/static/v1?logo=MIT&color=Blue&message=MIT&label=License"/></a>
<a href="#" alt="coverage"><img src="https://img.shields.io/static/v1?logo=Coverage&label=Coverage&message=80%&color=yellowgreen"/></a>
<a href="https://github.com/psf/black"><img src="https://img.shields.io/static/v1?label=Code style&message=black&color=Black"/></a>
<a href="#"><img alt="progress" src="https://img.shields.io/static/v1?logo=Progress&label=Progress&message=60%&color=green"/></a>
<a href="https://wakatime.com/badge/user/321c8a21-57bc-4782-bb00-8733ff579c0d/project/9681babc-aedd-4a02-ae7c-f91f914ad9b3"><img src="https://wakatime.com/badge/user/321c8a21-57bc-4782-bb00-8733ff579c0d/project/9681babc-aedd-4a02-ae7c-f91f914ad9b3.svg" alt="wakatime"/></a>
</p>
```
tttt 555555555555555555
ttt:::t 5::::::::::::::::5
t:::::t 5::::::::::::::::5
t:::::t 5:::::555555555555
yyyyyyy yyyyyyyttttttt:::::ttttttt 5:::::5
y:::::y y:::::y t:::::::::::::::::t 5:::::5
y:::::y y:::::y t:::::::::::::::::t 5:::::5555555555
y:::::y y:::::y tttttt:::::::tttttt 5:::::::::::::::5
y:::::y y:::::y t:::::t 555555555555:::::5
y:::::y y:::::y t:::::t 5:::::5
y:::::y:::::y t:::::t 5:::::5
y:::::::::y t:::::t tttttt5555555 5:::::5
y:::::::y t::::::tttt:::::t5::::::55555::::::5
y:::::y tt::::::::::::::t 55:::::::::::::55
y:::::y tt:::::::::::tt 55:::::::::55
y:::::y ttttttttttt 555555555
y:::::y
y:::::y
y:::::y
y:::::y
yyyyyyy
```
- **yt5** is a [Python](https://python.org) script that downloads [YouTube](https://www.youtube.com) ***Videos*** & ***audios*** at `console` environment.
## Installation ##
- From Github - *source*
```
git clone https://github.com/Simatwa/yt5.git
cd yt5
python setup.py install
```
- From Pypi
```
pip install yt5
```
## Usage ##
#### Video ####
- Videos can be downloaded by parsing a `URI` <sup>prefixed</sup> or <sub>postfixed</sub> by its category:
- For instances:
1. Single video :
```
$ yt5 url <Video-URI>
```
![yt52](https://github.com/Simatwa/yt5/raw/main/assets/yt52.jpg)
- Alternatively, this can be done by omitting `url` command since it's the default category.
```
$ yt5 <Video-URI>
```
![yt51](https://github.com/Simatwa/yt5/raw/main/assets/yt51.jpg)
2. All videos in a Playlist :
```
$ yt5 playlist <Playlist-URI>
```
![yt53](https://github.com/Simatwa/yt5/raw/main/assets/yt53.jpg)
3. All videos in a Channel :
```
$ yt5 channel <Channel-URI>
```
![yt54](https://github.com/Simatwa/yt5/raw/main/assets/yt54.jpg)
4. Collection of single-video's URI contained in a text file :
```
$ yt5 fnm <file-path>
```
![yt55](https://github.com/Simatwa/yt5/raw/main/assets/yt55.jpg)
#### Audio ####
- Audio of a video can be downloaded by adding `--mp3` to the commands parsed.
- For instance:
1. Single audio :
```
$ yt5 url <Video-URI> --mp3
```
![yt56](https://github.com/Simatwa/yt5/raw/main/assets/yt56.jpg)
- Similarly, this can be done to **other** ***categories***.
- For further information you can run:
```
$ yt5 -h
```
* Output :
```
usage: yt5 [-h] [-v] [-res [720p|480p|360p|240p|144p]] [-max MAXIMUM] [-dir DIRECTORY] [--mp3]
[--show] [--static] [--usage]
[[fnm|url|playlist|channel]] url
positional arguments:
[fnm|url|playlist|channel]
Category of the videos referred by the link or filename[fnm] containing
links
url Link of the video
options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-res [720p|480p|360p|240p|144p], --resolution [720p|480p|360p|240p|144p]
Resolution [quality] of videos to be downloaded in
-max MAXIMUM, --maximum MAXIMUM
Maximum videos to be downloaded
-dir DIRECTORY, --directory DIRECTORY
Directory for saving downloaded file
--mp3 Specify to download audio only
--show Show the downloaded file-path
--static Restricts stdout of file-path in prose-format
--usage Show this help info in more stylistic way
```
## Independencies ##
1. [pytube](https://github.com/pytube/pytube)
2. [colorama](https://github.com/pytube/pytube)
3. [tabulate](https://github.com/astanin/python-tabulate)
* [Review](requirements.txt).
## Acknowledgements ##
- [x] [Pytube](https://github.com/pytube/pytube)
- [x] [Python Team](https://python.org)
Raw data
{
"_id": null,
"home_page": "https://github.com/Simatwa/yt5",
"name": "yt5",
"maintainer": "Smartwa Caleb",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "yt5,youtubedl,youtube,downloader,video-downloader",
"author": "Smartwa Caleb",
"author_email": "smartwacaleb@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4e/18/6008aa9434b31df167be0ef41ebb93ce882a4097f8264be532590ce4f3cc/yt5-1.5.3.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n<a href=\"https://github.com/Simatwa/yt5\"><img src=\"https://img.shields.io/static/v1?logo=github&color=blueviolet&label=Test&message=Pass\"/></a>\n<a href=\"LICENSE\"><img src=\"https://img.shields.io/static/v1?logo=MIT&color=Blue&message=MIT&label=License\"/></a>\n<a href=\"#\" alt=\"coverage\"><img src=\"https://img.shields.io/static/v1?logo=Coverage&label=Coverage&message=80%&color=yellowgreen\"/></a>\n<a href=\"https://github.com/psf/black\"><img src=\"https://img.shields.io/static/v1?label=Code style&message=black&color=Black\"/></a>\n<a href=\"#\"><img alt=\"progress\" src=\"https://img.shields.io/static/v1?logo=Progress&label=Progress&message=60%&color=green\"/></a>\n<a href=\"https://wakatime.com/badge/user/321c8a21-57bc-4782-bb00-8733ff579c0d/project/9681babc-aedd-4a02-ae7c-f91f914ad9b3\"><img src=\"https://wakatime.com/badge/user/321c8a21-57bc-4782-bb00-8733ff579c0d/project/9681babc-aedd-4a02-ae7c-f91f914ad9b3.svg\" alt=\"wakatime\"/></a>\n</p>\n\n```\n \n \n tttt 555555555555555555 \n ttt:::t 5::::::::::::::::5 \n t:::::t 5::::::::::::::::5 \n t:::::t 5:::::555555555555 \nyyyyyyy yyyyyyyttttttt:::::ttttttt 5:::::5 \n y:::::y y:::::y t:::::::::::::::::t 5:::::5 \n y:::::y y:::::y t:::::::::::::::::t 5:::::5555555555 \n y:::::y y:::::y tttttt:::::::tttttt 5:::::::::::::::5 \n y:::::y y:::::y t:::::t 555555555555:::::5 \n y:::::y y:::::y t:::::t 5:::::5\n y:::::y:::::y t:::::t 5:::::5\n y:::::::::y t:::::t tttttt5555555 5:::::5\n y:::::::y t::::::tttt:::::t5::::::55555::::::5\n y:::::y tt::::::::::::::t 55:::::::::::::55 \n y:::::y tt:::::::::::tt 55:::::::::55 \n y:::::y ttttttttttt 555555555 \n y:::::y \n y:::::y \n y:::::y \n y:::::y \n yyyyyyy \n \n \n```\n- **yt5** is a [Python](https://python.org) script that downloads [YouTube](https://www.youtube.com) ***Videos*** & ***audios*** at `console` environment.\n\n## Installation ##\n- From Github - *source*\n\n```\ngit clone https://github.com/Simatwa/yt5.git\ncd yt5\npython setup.py install\n\n```\n\n- From Pypi\n\n```\npip install yt5\n```\n\n## Usage ##\n\n#### Video #### \n\n- Videos can be downloaded by parsing a `URI` <sup>prefixed</sup> or <sub>postfixed</sub> by its category:\n- For instances:\n1. Single video :\n\n```\n$ yt5 url <Video-URI>\n\n```\t\t\n![yt52](https://github.com/Simatwa/yt5/raw/main/assets/yt52.jpg)\n \n- Alternatively, this can be done by omitting `url` command since it's the default category.\n\n```\n$ yt5 <Video-URI>\n\n```\n![yt51](https://github.com/Simatwa/yt5/raw/main/assets/yt51.jpg)\n\n\n2. All videos in a Playlist :\n\n```\n$ yt5 playlist <Playlist-URI>\n\n```\n![yt53](https://github.com/Simatwa/yt5/raw/main/assets/yt53.jpg)\n\t \n3. All videos in a Channel : \n\n```\n$ yt5 channel <Channel-URI>\n\n```\n![yt54](https://github.com/Simatwa/yt5/raw/main/assets/yt54.jpg)\n\t\t\n4. Collection of single-video's URI contained in a text file : \n\n```\n$ yt5 fnm <file-path>\n\n```\n![yt55](https://github.com/Simatwa/yt5/raw/main/assets/yt55.jpg)\n\t\t\t\n#### Audio #### \n\n- Audio of a video can be downloaded by adding `--mp3` to the commands parsed.\n - For instance:\n1. Single audio : \n \t\t\n```\n$ yt5 url <Video-URI> --mp3\n\n```\n\n![yt56](https://github.com/Simatwa/yt5/raw/main/assets/yt56.jpg)\n \n- Similarly, this can be done to **other** ***categories***.\n\n- For further information you can run:\n\t\n```\n$ yt5 -h\n\n``` \n\n* Output :\n\n```\nusage: yt5 [-h] [-v] [-res [720p|480p|360p|240p|144p]] [-max MAXIMUM] [-dir DIRECTORY] [--mp3]\n [--show] [--static] [--usage]\n [[fnm|url|playlist|channel]] url\n\npositional arguments:\n [fnm|url|playlist|channel]\n Category of the videos referred by the link or filename[fnm] containing\n links\n url Link of the video\n\noptions:\n -h, --help show this help message and exit\n -v, --version show program's version number and exit\n -res [720p|480p|360p|240p|144p], --resolution [720p|480p|360p|240p|144p]\n Resolution [quality] of videos to be downloaded in\n -max MAXIMUM, --maximum MAXIMUM\n Maximum videos to be downloaded\n -dir DIRECTORY, --directory DIRECTORY\n Directory for saving downloaded file\n --mp3 Specify to download audio only\n --show Show the downloaded file-path\n --static Restricts stdout of file-path in prose-format\n --usage Show this help info in more stylistic way\n\n```\n\n\n## Independencies ##\n\n1. [pytube](https://github.com/pytube/pytube)\n2. [colorama](https://github.com/pytube/pytube)\n3. [tabulate](https://github.com/astanin/python-tabulate)\n \n * [Review](requirements.txt).\n\n\n## Acknowledgements ##\n\n- [x] [Pytube](https://github.com/pytube/pytube)\n- [x] [Python Team](https://python.org)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Download YouTube Videos and Audios",
"version": "1.5.3",
"split_keywords": [
"yt5",
"youtubedl",
"youtube",
"downloader",
"video-downloader"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3bf5817fb7bbbf73cab881dc66ff43e3c4ec509882c93830f9daf059c2217c99",
"md5": "d0ac0c268aeb89c1227863af9a73eaa6",
"sha256": "192597c6e9bced162044fbed01a63fd28a2f060b4149a94d45b3e365d309d83d"
},
"downloads": -1,
"filename": "yt5-1.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d0ac0c268aeb89c1227863af9a73eaa6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8200,
"upload_time": "2023-04-23T20:55:47",
"upload_time_iso_8601": "2023-04-23T20:55:47.527694Z",
"url": "https://files.pythonhosted.org/packages/3b/f5/817fb7bbbf73cab881dc66ff43e3c4ec509882c93830f9daf059c2217c99/yt5-1.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4e186008aa9434b31df167be0ef41ebb93ce882a4097f8264be532590ce4f3cc",
"md5": "023fe5765cdafe7c557f276bf8242ec7",
"sha256": "0805e28af544ff7f11fb9b6883ae697d6a9687e18015ad4ff5821fcecfa02f50"
},
"downloads": -1,
"filename": "yt5-1.5.3.tar.gz",
"has_sig": false,
"md5_digest": "023fe5765cdafe7c557f276bf8242ec7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 9186,
"upload_time": "2023-04-23T20:55:49",
"upload_time_iso_8601": "2023-04-23T20:55:49.563237Z",
"url": "https://files.pythonhosted.org/packages/4e/18/6008aa9434b31df167be0ef41ebb93ce882a4097f8264be532590ce4f3cc/yt5-1.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-23 20:55:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "Simatwa",
"github_project": "yt5",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
},
{
"name": "pytube",
"specs": [
[
">=",
"12.1.2"
]
]
},
{
"name": "tabulate",
"specs": [
[
">=",
"0.9.0"
]
]
}
],
"lcname": "yt5"
}