Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anatolykopyl/youtube-cdl
📼 Bulk youtube subscription download
https://github.com/anatolykopyl/youtube-cdl
command-line command-line-tool data-hoarder python python3 youtube youtube-api youtube-dl youtube-downloader
Last synced: 19 days ago
JSON representation
📼 Bulk youtube subscription download
- Host: GitHub
- URL: https://github.com/anatolykopyl/youtube-cdl
- Owner: anatolykopyl
- License: gpl-3.0
- Created: 2021-04-10T17:49:14.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2021-04-16T16:07:47.000Z (over 3 years ago)
- Last Synced: 2024-11-08T12:43:24.019Z (about 1 month ago)
- Topics: command-line, command-line-tool, data-hoarder, python, python3, youtube, youtube-api, youtube-dl, youtube-downloader
- Language: Python
- Homepage:
- Size: 379 KB
- Stars: 71
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - anatolykopyl/youtube-cdl - 📼 Bulk youtube subscription download (Python)
README
# youtube-cdl
*Command line tool based on youtube-dl to easily download selected channels from your subscriptions.*
This tool is very handy if you want to hoard a lot of videos, but not all of them.
## Setup:
1. Clone repo & install dependencies:
```bash
git clone https://github.com/anatolykopyl/youtube-cdl.git
cd youtube-cdl
pip install -r requirements.txt
# If on windows instead run
# pip install -r windows.txt
```
2. Create or select a project in the [API Console](https://console.developers.google.com/).
Complete the following tasks in the API Console for your project:
1. In the [library panel](https://console.developers.google.com/apis/library),
search for the YouTube Data API v3. Click into the listing for that API and make
sure the API is enabled for your project.
2. In the [credentials panel](https://console.developers.google.com/apis/credentials), create an **OAuth client ID.**
This will need you to configure your consent screen:
* Only "App name", "User support email" and "Developer contact email" fields are required.
* On "Test users" step add yourself (your email address).
After you've set up your consent screen go back to the "Credentials" tab
and create OAuth Client ID credentials.
Set the application type to Desktop App.
Download the JSON file that contains your OAuth 2.0 credentials. The file
has a name like client_secret_CLIENTID.json, where CLIENTID is the client ID
for your project.
3. Rename the downloaded file to `client_secrets.json` and put it in the project root.
4. Run the script:
```bash
python main.py
```
## Usage:
* Run the script and go through your subscriptions one by one:
```bash
python main.py
```
* Specify format [like in youtube-dl](https://github.com/ytdl-org/youtube-dl#user-content-format-selection-examples):
```bash
python main.py -f 'bestaudio/best'
```
* Download all the videos from all channels you're subscribed to:
```bash
python main.py -a
```
* Download into a specified directory:
```bash
python main.py -o path/to/dir
```
When you go through all of your subscriptions and mark all of them as `y/n` your selections
will be saved in `download_list.json`.
If for some reason you stopped the script, you can
continue downloading without going through all of your subscriptions again by running
`python main.py -i download_list.json`.
Or if you made a mistake while going through the channels you can just edit `download_list.json`
and rerun with it passed as an argument.