Home

Welcome to the MeTube wiki — the companion to the README. The README has the quick start and the reference for every environment variable; the wiki has everything else: guides, recipes, integrations, and troubleshooting.

Using MeTube

• Subscriptions — auto-download new uploads from channels and playlists.
• Using browser cookies — download private, age-restricted, and "confirm you're not a bot" videos.
• Sending links to MeTube — browser extensions, bookmarklets, iOS and Android apps, Raycast.
  • Bookmarklets — send the current browser page to MeTube with one click.

Configuring downloads

• yt-dlp options — global options, presets, and per-download overrides, and how they combine.
• YTDL_OPTIONS Cookbook — example configurations: notifications, metadata, SponsorBlock chapters, and more.
• Output templates — how MeTube names files and sorts them into folders.
• OUTPUT_TEMPLATE Cookbook — example filename templates.
• Hardware-accelerated transcoding — re-encode downloads on an Intel/AMD GPU.
• yt-dlp plugins — load yt-dlp plugins into the container, e.g. to accept links from Invidious or Piped.

Deployment

• Reverse proxy configurations — built-in HTTPS, and NGINX, Apache, Caddy, and swag examples.

Help

• Troubleshooting FAQ — common issues and how to diagnose them.

---

To contribute a recipe or configuration, open an issue with the snippet and a short description of what it does — it will be added here with attribution.