youtube setup

the youtube extractor is currently based on the invidious api.

why invidious

using invidious as a backend for youtube extraction provides several advantages:

• avoids ip bans and rate limits from youtube
• removes the need to bypass captchas or bot protections
• allows you to use public or self-hosted invidious instances
• provides a stable, simplified api for accessing video info and streams

setup

you must specify one or more invidious instances in your private/config.yaml file:

youtube:
  instance:
    - https://invidious.example.com
    - https://another-invidious.example.com

th bot will try each instance in order until one succeeds. this provides redundancy in case an instance is temporarily unavailable.

finding public instances

you can find a list of public invidious instances at:

• docs.invidious.io/instances
• api.invidious.io

self-hosting invidious

for best results, consider running your own invidious instance. refer to the official documentation for setup instructions.