= download-yt-feeds
:url-zsh: https://www.zsh.org/
:url-ytdl: https://github.com/ytdl-org/youtube-dl
:url-ytdl-format: {url-ytdl}/#format-selection

Download YouTube-feeds like they are podcasts. Files will be put in `<download_dir>/channel/title.extension`.

== Install

Put `download-yt-feeds` somewhere in your `${PATH}` and make it executable.

=== Dependencies

* Linux (*BSD and other UNIXes should work, but I haven't tested)
* link:{url-zsh}[Zsh]
* link:{url-ytdl}[youtube-dl]

== Configuration

The configuration directory is `${XDG_CONFIG_HOME}/download-yt-feeds` or, if
`${XDG_CONFIG_HOME}` is not set, `${HOME}/.config/download-yt-feeds`. You need 2
files in this directory, `config` and `feedlist`.

=== config

.Example configuration file
[source,shell]
--------------------------------------------------------------------------------
# This file will be source-d.
download_dir="/home/user/Podcasts/youtube"
keep_for_days="14"
ytdl_format="bestvideo[height<=1080]+bestaudio/best[height<=1080]"
--------------------------------------------------------------------------------

|===============================================================================
| *download_dir*    | The directory to which the videos will be downloaded.
| *keep_for_days*   | Download only videos newer than this many days and delete older videos.
| *ytdl_format*     | Same syntax as link:{url-ytdl-format}[youtube-dl --format]. Default is "best".
| *ytdl_extra_args* | Extra arguments for `youtube-dl`. Optional.
|===============================================================================


=== feedlist

A "feed" in this context is a URL to a page that lists YouTube-videos, not an
RSS or Atom feed.

.Example feed list
[source,cfg]
--------------------------------------------------------------------------------
# Everything that doesn't start with "http" will be skipped.
https://www.youtube.com/channel/UCyczvB_IvA7V1a5BXXu3CRg/videos # Karakaya Talks
https://www.youtube.com/user/lefticus1/videos # C++ Weekly
--------------------------------------------------------------------------------