Youtube Downloader
==================
Introduction
------------
Download youtube videos and convert them to mp3.
User Guide
----------
How to Install
++++++++++++++
To install `ytb_downloader` by running::
$ pip install ytb_downloader
How to Use
++++++++++
You can use the command line tool from `ytb_downloader` to download audios or videos
from Youtube.
Download Audio
~~~~~~~~~~~~~~
Start downloading a single audio by calling::
$ ytb_downloader "<your youtube video url>"
If you want to specify the format of the downloaded video, you can use the option
`--format` or `-f` with the format as string, such as::
$ ytb_downloader --format "mp3" "https://www.youtube.com/watch?v=nOubjLM9Cbc"
For more details, please execute::
$ ytb_downloader --help
Download Video
~~~~~~~~~~~~~~
Start downloading a single video by calling::
$ ytb_downloader --video-only "<your youtube video url>"
Download in bulk
~~~~~~~~~~~~~~~~
If you want to download audios in bulk, please prepare a *csv* file containing all
the urls of the audios. Here is an example about how does this csv file look like.
.. list-table:: example-url-only.csv
:widths: 25
:header-rows: 1
* - url
* - https://www.youtube.com/watch?v=WqkjYKUXERQ
* - https://www.youtube.com/watch?v=nOubjLM9Cbc
Here is the content of the example-url-only.csv file::
url
https://www.youtube.com/watch?v=WqkjYKUXERQ
https://www.youtube.com/watch?v=nOubjLM9Cbc
In the csv file, you can also specify the *format*, *time_start*, *time_end* and *bitrate*
for each audio, such as
.. list-table:: example.csv
:widths: 50 25 25 25 25 25
:header-rows: 1
* - url
- format
- time_start
- time_end
- fps
- bitrate
* - https://www.youtube.com/watch?v=WqkjYKUXERQ
- mp3
- 0
-
- 44100
- 3000k
* - https://www.youtube.com/watch?v=nOubjLM9Cbc
- mp3
- 3
- 100
- 200
- 500k
Here is the content of the example.csv file::
url,format,time_start,time_end,fps,bitrate
https://www.youtube.com/watch?v=WqkjYKUXERQ,mp3,0,,44100,3000k
https://www.youtube.com/watch?v=nOubjLM9Cbc,mp3,3,100,200,500k
To download all the audios from the urls listed in this file by calling::
$ ytb_downloader_bulk example.csv
If you want to download the videos only, you need to provide a csv file with
one column *url*, and list all the urls you want to download in that column. Then
execute::
$ ytb_downloader_bulk --video-only example.csv
Maintainers
-----------
..
TODO: List here the people responsible for the development and maintaining of this project.
Format: **Name** - *Role/Responsibility* - Email
* **Zhiwei Zhang** - *Maintainer* - `zhiwei2017@gmail.com <mailto:zhiwei2017@gmail.com?subject=[GitHub]Youtube%20Downloader>`_
.. _bandit: https://bandit.readthedocs.io/en/latest/
.. _mypy: https://github.com/python/mypy
.. _pytest: https://docs.pytest.org/en/stable/
Raw data
{
"_id": null,
"home_page": "https://github.com/zhiwei2017/ytb_downloader",
"name": "ytb-downloader",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Zhiwei Zhang",
"author_email": "zhiwei2017@gmail.com",
"download_url": null,
"platform": null,
"description": "Youtube Downloader\n==================\n\nIntroduction\n------------\nDownload youtube videos and convert them to mp3.\n\nUser Guide\n----------\n\nHow to Install\n++++++++++++++\n\nTo install `ytb_downloader` by running::\n\n $ pip install ytb_downloader\n\nHow to Use\n++++++++++\n\nYou can use the command line tool from `ytb_downloader` to download audios or videos\nfrom Youtube.\n\nDownload Audio\n~~~~~~~~~~~~~~\nStart downloading a single audio by calling::\n\n $ ytb_downloader \"<your youtube video url>\"\n\nIf you want to specify the format of the downloaded video, you can use the option\n`--format` or `-f` with the format as string, such as::\n\n $ ytb_downloader --format \"mp3\" \"https://www.youtube.com/watch?v=nOubjLM9Cbc\"\n\nFor more details, please execute::\n\n $ ytb_downloader --help\n\nDownload Video\n~~~~~~~~~~~~~~\nStart downloading a single video by calling::\n\n $ ytb_downloader --video-only \"<your youtube video url>\"\n\nDownload in bulk\n~~~~~~~~~~~~~~~~\nIf you want to download audios in bulk, please prepare a *csv* file containing all\nthe urls of the audios. Here is an example about how does this csv file look like.\n\n.. list-table:: example-url-only.csv\n :widths: 25\n :header-rows: 1\n\n * - url\n * - https://www.youtube.com/watch?v=WqkjYKUXERQ\n * - https://www.youtube.com/watch?v=nOubjLM9Cbc\n\nHere is the content of the example-url-only.csv file::\n\n url\n https://www.youtube.com/watch?v=WqkjYKUXERQ\n https://www.youtube.com/watch?v=nOubjLM9Cbc\n\nIn the csv file, you can also specify the *format*, *time_start*, *time_end* and *bitrate*\nfor each audio, such as\n\n.. list-table:: example.csv\n :widths: 50 25 25 25 25 25\n :header-rows: 1\n\n * - url\n - format\n - time_start\n - time_end\n - fps\n - bitrate\n * - https://www.youtube.com/watch?v=WqkjYKUXERQ\n - mp3\n - 0\n -\n - 44100\n - 3000k\n * - https://www.youtube.com/watch?v=nOubjLM9Cbc\n - mp3\n - 3\n - 100\n - 200\n - 500k\n\nHere is the content of the example.csv file::\n\n url,format,time_start,time_end,fps,bitrate\n https://www.youtube.com/watch?v=WqkjYKUXERQ,mp3,0,,44100,3000k\n https://www.youtube.com/watch?v=nOubjLM9Cbc,mp3,3,100,200,500k\n\nTo download all the audios from the urls listed in this file by calling::\n\n $ ytb_downloader_bulk example.csv\n\nIf you want to download the videos only, you need to provide a csv file with\none column *url*, and list all the urls you want to download in that column. Then\nexecute::\n\n $ ytb_downloader_bulk --video-only example.csv\n\nMaintainers\n-----------\n\n..\n TODO: List here the people responsible for the development and maintaining of this project.\n Format: **Name** - *Role/Responsibility* - Email\n\n* **Zhiwei Zhang** - *Maintainer* - `zhiwei2017@gmail.com <mailto:zhiwei2017@gmail.com?subject=[GitHub]Youtube%20Downloader>`_\n\n.. _bandit: https://bandit.readthedocs.io/en/latest/\n.. _mypy: https://github.com/python/mypy\n.. _pytest: https://docs.pytest.org/en/stable/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Download youtube videos and convert them to mp3.",
"version": "0.4.0",
"project_urls": {
"Documentation": "https://zhiwei2017.github.io/ytb_downloader/",
"Homepage": "https://github.com/zhiwei2017/ytb_downloader",
"Repository": "https://github.com/zhiwei2017/ytb_downloader"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "09863488e417c809860b03b7f8518b20364cbcac22a439b7a4b80bd4b67d37f4",
"md5": "04ce8c7d10afc28a7f9b4a04913118de",
"sha256": "efedf19f2fb951c137d4d3c04f14aa70eefa81a6f2e4a544e9a38226eedcf4d4"
},
"downloads": -1,
"filename": "ytb_downloader-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "04ce8c7d10afc28a7f9b4a04913118de",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 9042,
"upload_time": "2024-11-17T23:00:31",
"upload_time_iso_8601": "2024-11-17T23:00:31.247226Z",
"url": "https://files.pythonhosted.org/packages/09/86/3488e417c809860b03b7f8518b20364cbcac22a439b7a4b80bd4b67d37f4/ytb_downloader-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-17 23:00:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zhiwei2017",
"github_project": "ytb_downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ytb-downloader"
}
JSON
