FAQ#

Since ytdl-sub is relatively new to the public, there has not been many question asked yet. We will update this as more questions get asked.

How do I…#

…remove the date in the video title?#

The TV Show presets by default include the upload date in the episode_title override variable. This variable is used to set the title in things like the video metadata, NFO file, etc, which is subsequently read by media players. This can be overwritten as you see fit by redefining it:

overrides:
  episode_title: "{title}"  # Only sets the video title

…get support or reach out to contribute?#

If you need support, you can:

If you would like to contribute, we’re happy to accept any help, even non-coders! To find out how you can help this project, you can:

  • Join our Discord and leave a comment in #development with where you think you can assist or what skills you would like to contribute.

  • If you just want to fix one thing, you’re welcome to submit a pull request with information on what issue you’re resolving and it will be reviewed as soon as possible.

…download age-restricted YouTube videos?#

See yt-dl’s recommended way to download your YouTube cookie, then add it to your ytdl options section of your config:

ytdl_options:
  cookiefile: "/path/to/cookies/file.txt"

…automate my downloads?#

This page shows how to set up ytdl-sub to run automatically on various platforms.

There is a bug where…#

…date_range is not downloading older videos after I changed the range#

Your preset most likely has break_on_existing set to True, which will stop downloading additional metadata/videos if the video exists in your download archive. Set the following in your config to skip downloading videos that exist instead of stopping altogether.

ytdl_options:
  break_on_existing: False

After you download your new date_range duration, re-enable break_on_existing to speed up successive downloads.

…it is downloading non-English title and description metadata#

Most likely the video has a non-English language set to its ‘native’ language. You can tell yt-dlp to explicitly download English metadata using.

ytdl_options:
  extractor_args:
    youtube:
      lang:
        - "en"

…Plex is not showing my TV shows correctly#

  1. Set the following for your ytdl-sub library that has been added to Plex.

The Plex library editor, under the advanced settings, showing the required options for Plex to show the TV shows correctly.
  • Scanner: Plex Series Scanner

  • Agent: Personal Media shows

  • Visibility: Exclude from home screen and global search

  • Episode sorting: Library default

  • YES Enable video preview thumbnails

  1. Under Settings > Agents, confirm Plex Personal Media Shows/Movies scanner has Local Media Assets enabled.

The Plex Agents settings page has Local Media Assets enabled for Personal Media Shows and Movies tabs.