ff66ff5be0
* docs(docker): Recommended image DEFAULT_WORKSPACE * fix(docker): Add default crontab download command Clarify the `/config/ytdl-sub-configs/cron` script with explanatory comments and a default `--dry-run` command. Also change the wrapper script to echo commands for easier debugging. To update an existing script, move the old script aside, restart the container to regenerate it, and edit the new script. Also clarify the Automating page in the Getting Started guide docs. * fix(docker): Unintentional unattended dry runs [PR feedback](https://github.com/jmbannon/ytdl-sub/pull/1321#discussion_r2315215600) prompted me to reconsider having a default command at all. We should assume, unfortunately, that many new users will just skim the docs enough to enable the image's cron integration but not actually incrementally test their configuration. In those cases, they'd end up sending dry-run non-download requests for all their subscriptions every 6 hours for no good reason. There's just no way to provide a default command that isn't also providing a footgun. * docs(docker): More open cron schedule generator From [PR feedback](https://github.com/jmbannon/ytdl-sub/pull/1321#discussion_r2320521024), this seems like less of an ad than the previous and the source for the page is itself open source. * docs(docker): Document image environment footgun From [PR feedback](https://github.com/jmbannon/ytdl-sub/pull/1321#discussion_r2320515419). * docs(automate): Avoid external link 404 responses * docs(automate): False simultaneous run warning * docs(automate): Clarify Docker daemon restarts * docs(automate): Revert run start non-recommended * docs(automate): Remove footgun manual run command Addressing this underlying issue requires more thought and should be a separate PR. * docs(automate): Restore env var footgun in example
88 lines
3 KiB
YAML
88 lines
3 KiB
YAML
# subscriptions.yaml:
|
|
# Everything in here can be downloaded using the command:
|
|
# ytdl-sub sub subscriptions.yaml
|
|
|
|
# __preset__ is a place to define global overrides for all subscriptions
|
|
__preset__:
|
|
overrides:
|
|
# Root folder of all ytdl-sub TV Shows
|
|
tv_show_directory: "/tv_shows"
|
|
|
|
# Root folder of all ytdl-sub Music
|
|
music_directory: "/music"
|
|
|
|
# Root folder of all ytdl-sub Music Videos
|
|
music_video_directory: "/music_videos"
|
|
|
|
# For 'Only Recent' preset, only keep vids within this range and limit
|
|
# only_recent_date_range: "2months"
|
|
# only_recent_max_files: 30
|
|
|
|
# Pass any arg directly to yt-dlp's Python API
|
|
# ytdl_options:
|
|
# cookiefile: "/config/ytdl-sub-configs/cookie.txt"
|
|
|
|
###################################################################
|
|
# Subscriptions nested under this will use the
|
|
# `Plex TV Show by Date` preset.
|
|
#
|
|
# Can choose between:
|
|
# - Plex TV Show by Date:
|
|
# - Jellyfin TV Show by Date:
|
|
# - Kodi TV Show by Date:
|
|
Plex TV Show by Date:
|
|
|
|
# Sets genre tag to "Documentaries"
|
|
= Documentaries:
|
|
"NOVA PBS": "https://www.youtube.com/@novapbs"
|
|
# "National Geographic": "https://www.youtube.com/@NatGeo"
|
|
# "Cosmos - What If": "https://www.youtube.com/playlist?list=PLZdXRHYAVxTJno6oFF9nLGuwXNGYHmE8U"
|
|
|
|
# Sets genre tag to "Kids", "TV-Y" for content rating
|
|
# = Kids | = TV-Y:
|
|
# "Jake Trains": "https://www.youtube.com/@JakeTrains"
|
|
# "Kids Toys Play": "https://www.youtube.com/@KidsToysPlayChannel"
|
|
|
|
# = Music:
|
|
# # TV show subscriptions can support multiple urls and store in the same TV Show
|
|
# "Rick Beato":
|
|
# - "https://www.youtube.com/@RickBeato"
|
|
# - "https://www.youtube.com/@rickbeato240"
|
|
|
|
# Set genre tag to "News", use `Only Recent` preset to only store videos uploaded recently
|
|
# = News | Only Recent:
|
|
# "BBC News": "https://www.youtube.com/@BBCNews"
|
|
|
|
###################################################################
|
|
# Subscriptions nested under these will use the various prebuilt
|
|
# music presets
|
|
|
|
# YouTube Releases:
|
|
# = Jazz: # Sets genre tag to "Jazz"
|
|
# "Thelonious Monk": "https://www.youtube.com/@theloniousmonk3870/releases"
|
|
|
|
# YouTube Full Albums:
|
|
# = Lofi:
|
|
# "Game Chops": "https://www.youtube.com/playlist?list=PLBsm_SagFMmdWnCnrNtLjA9kzfrRkto4i"
|
|
|
|
# SoundCloud Discography:
|
|
# = Chill Hop:
|
|
# "UKNOWY": "https://soundcloud.com/uknowymunich"
|
|
# = Synthwave:
|
|
# "Lazerdiscs Records": "https://soundcloud.com/lazerdiscsrecords"
|
|
# "Earmake": "https://soundcloud.com/earmake"
|
|
|
|
# Bandcamp:
|
|
# = Lofi:
|
|
# "Emily Hopkins": "https://emilyharpist.bandcamp.com/"
|
|
|
|
###################################################################
|
|
# Can choose between:
|
|
# - Plex Music Videos:
|
|
# - Jellyfin Music Videos:
|
|
# - Kodi Music Videos:
|
|
|
|
# "Plex Music Videos":
|
|
# = Pop: # Sets genre tag to "Pop"
|
|
# "Rick Astley": "https://www.youtube.com/playlist?list=PLlaN88a7y2_plecYoJxvRFTLHVbIVAOoc"
|
|
# "Michael Jackson": "https://www.youtube.com/playlist?list=OLAK5uy_mnY03zP6abNWH929q2XhGzWD_2uKJ_n8E"
|