xiry.

Development · GitHub repo

bgutil-ytdlp-pot-provider

Proof-of-origin token provider plugin for yt-dlp to bypass YouTube bot checks

From the Xiry library · Updated 3 October 2026

Visit github.com ↗

A yt-dlp plugin and server that generates YouTube Proof-of-Origin (PO) tokens via LuanRT's Botguard library. It helps yt-dlp circumvent "Sign in to confirm you're not a bot" errors and rate-limiting when downloading from flagged or datacenter IP addresses. Tokens can be provided via a persistent HTTP/Docker daemon or on-demand scripts.

What it's for

  • Bypass YouTube bot checks and 403 errors when scraping or downloading videos via yt-dlp
  • Run automated media download pipelines reliably from datacenter IP addresses
  • Serve proof-of-origin tokens to multiple yt-dlp instances using a centralized Docker container

Features

  • Integrates directly with yt-dlp's PO Token Provider Framework
  • Generates PO tokens using LuanRT's Botguard interfacing library (BgUtils)
  • Offers an HTTP server mode with prebuilt Docker images (Node.js and Deno)
  • Supports on-demand script execution mode without a persistent daemon
  • Built-in caching mechanism with configurable TTL
  • Easy installation via PyPI or manual yt-dlp plugin folder drop-in

Pricing

Open source

Details

Type
GitHub repo
Category
Development
Topic
Scraping & Download Tools
Open source
Yes
Platforms
Command line, Self-hosted, Linux, macOS, Windows
For
Developers and self-hosters managing video downloads and media pipelines with yt-dlp
Alternative to
yt-dlp manual cookie extraction
Tags
yt dlp, youtube, downloader, botguard, docker, cli

Why it was saved

  • @remy.engineering, 10 September 2026: Allows yt-dlp to bypass YouTube bot detection and download videos from video platforms reliably without throttling.

Related

  • youtube-dl

    Command-line tool to download videos, audio, and metadata from video platforms

  • agent-browser

    Browser automation CLI and engine purpose-built for AI agents

  • Boneyard

    Auto-generates pixel-perfect skeleton screens directly from your real rendered DOM

  • How to self-host a Next.js app on a Hetzner VM using Kamal

    Step-by-step tutorial for deploying Next.js to Hetzner using Kamal

  • Mole

    Open-source macOS command-line toolkit for disk cleanup, uninstallation, and system monitoring

  • Argus

    Python interactive CLI toolkit for automated OSINT, network reconnaissance, and security checks

Updated