Skip to main content

Tool to auto-download new playlist entries.

Project description

Overview

This tool knows how to poll for changes to playlist(s) and to then download the physical videos for the new items automatically (using youtube-dl).

Features

  • More than one playlist can be provided.

  • The state is recorded for each playlist during each call. This is how the differences are calculated.

  • Uses python-googleautoauth for authentication.

  • Will gracefully accommodate multiple instances being run concurrently.

Installation

$ pip install youtube-autodownloader

Usage

The first time you run, you will have to build new credentials. The automatic-authentication flow will automatically run and open a browser window. To specifically run just the authorization, run:

$ ytad_autoauth

This works best in a desktop environment. Manual-authorization helper scripts are also provided to support console-only environment.

Since YouTube does not enforce uniqueness for playlist names, you are required to provide playlist IDs rather than names.

Example of finding a playlist ID using a playlist name:

$ ytad_search_playlists Animals
PLxaR7YEkaI0xxxxxxxxxxxxxxacWvmEih

$ ytad_search_playlists Special
PLxaR7YEkaI0xxxxxxxxxxxxxxr1gs86gE

Example of checking for and downloading new videos (“-p” is a playlist-ID, “-dp” is the download-path):

$ ytad_autodownload -p PLxaR7YEkaI0xxxxxxxxxxxxxxr1gs86gE -dp "/storage/videos/$(date '+\%Y')/Special"
Lion Vs Mongoose: Mongoose Fends Off Four Lions
- Playlist: Special
- ID: 1TPn1-SJqVM
- Download time: 9s
- Filename: 20140902 - Lion Vs Mongoose - Mongoose Fends Off Four Lions (1TPn1-SJqVM).mp4
- Size: 22.1M

Slow loris loves getting tickled http://bit.ly/14qLq8x
- Playlist: Special
- ID: PZ5ACLVjYwM
- Download time: 3s
- Filename: 20090426 - Slow loris loves getting tickled http -_bit.ly_14qLq8x (PZ5ACLVjYwM).webm
- Size: 3.1M

Testing

To run the tests:

$ ./test.sh

The tests will require user interaction with the browser.

Notes

  • If you do not wish to download the videos the first time that you run this command, omit the download-path parameter. This will just build the local database. Otherwise, all videos from the playlist will download. This might not be desireable for your use-case.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

youtube-autodownloader-0.2.6.tar.gz (13.2 kB view details)

Uploaded Source

File details

Details for the file youtube-autodownloader-0.2.6.tar.gz.

File metadata

File hashes

Hashes for youtube-autodownloader-0.2.6.tar.gz
Algorithm Hash digest
SHA256 950722b1c0761f9cf07f33dd18a9193b5df1b552ada4b5437f703ce7f58d5975
MD5 eb11202c3df8bd1324066f1f831a3fb0
BLAKE2b-256 ac63812b73aec3bf0ef7e607f02781496caba7a4e1f3a1822618ea7178f7f282

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page