No description
Find a file
Ethan Dalool ed3942b943 Let response status be 0 even if request didn't complete.
Since meta.status would be undefined for an incomplete request,
I would have to check response.completed && response.meta.status,
which is too much burden. Let's set the status immediately, and
if a callback wants to do further diving we'll use completed then.
2020-10-02 19:43:25 -07:00
frontends Let response status be 0 even if request didn't complete. 2020-10-02 19:43:25 -07:00
utilities Add better indexes and delete redundant ones. 2020-10-02 11:22:47 -07:00
ycdl Improve error handling surrounding most_recent_video. 2020-10-02 12:31:39 -07:00
README.md Improve readme text. 2020-08-28 16:41:14 -07:00
requirements.txt Add experimental RSS-based refresh_all_channels. 2020-08-12 12:32:01 -07:00
ycdl_logo.svg Add ycdl_logo.svg. 2020-01-19 10:51:54 -08:00

Youtube Channel Downloader

YoutubeChannelDownloader creates an SQLite3 database of Youtube channels and their videos, and serves it out of a web server.

YCDL solves three main problems:

Metadata archive

The database acts as a permanent archive of video metadata including title, description, duration, view count, and more. Even if a video or channel is deleted from Youtube, you will still have this information. Perfect for never losing track of unlisted videos, too.

The thumbnails, however, are not stored in the database, but you can use utilities\download_thumbnails.py to download them.

Note: At this time, refreshing a channel in YCDL will update video titles, descriptions, and view counts with their current values. If you refresh a channel after they have changed their video's title or description you will lose the previous value.

Easily watch every video on the channel

When I discover a channel, I like to watch through the videos over the course of weeks or months. Within Youtube's own interface, there is no good way to filter videos you've watched from videos you haven't. Scrolling through all of a channel's videos to find ones you haven't seen is tough.

In YCDL, videos start off as pending and you can mark them as ignore or download. The pending page always acts as your "to-watch" list.

On Youtube's subscription page, there is a button to hide a video from the list. I would often press this hide button after watching a video, only to find it come back a few days later. Don't get me started on live broadcasts or premieres -- hiding those was never reliable. YCDL makes watching my subscriptions much easier.

Send video IDs to youtube-dl

YCDL does not perform the downloading of videos itself. youtube-dl is the tool for that. When you click on the download button, it will create an empty file called xxxxxxxxxxx.ytqueue in the directory specified by the ycdl.json config file. You can send this ID into youtube-dl in your preferred way.

Features

  • Web interface with video embeds
  • "Sub-box" page where newest videos from all channels are listed in order
  • Sort videos by date, duration, views, or random
  • Background thread will refresh channels over time
  • Automark channels as ignore or download

Your API key

You are responsible for your own bot.py file, with a function get_youtube_key. YCDL will import bot and call bot.get_youtube_key() with no arguments. It should return a Youtube API key. Here is how to get one:

  1. Go to https://console.developers.google.com/.
  2. Create a project using the menu in the upper left.
  3. From the project's dashboard, click "Enable APIs and Services".
  4. Search for and choose the latest YouTube Data API.
  5. On the left bar, click "Credentials".
  6. Click "Create credentials" and choose "API key". In my experience they all start with "AIzaSy".
  7. Return this value from get_youtube_key however you deem fit.

Screenshots

2020-04-04_15-27-15

2020-04-04_15-29-25

2020-04-04_15-36-05

2020-04-04_15-36-10

2020-04-04_15-40-27

To do list

  • Keep permanent record of titles and descriptions.
  • Progress indicator for channel refresh.