--- id: bgutil-ytdlp-pot-provider version: "1.3.1" license: unclear license_treatment: copyleft maintenance: active --- # bgutil-ytdlp-pot-provider License: copyleft · Maintenance: active · Downloads: 724.4K/mo ## What it is and what it does This package is a yt-dlp plugin that integrates proof-of-origin (PO) token generation into the video download workflow. When YouTube flags an IP address and demands sign-in confirmation before allowing downloads, this plugin can generate a PO token to make the traffic appear more legitimate and potentially bypass that check. The plugin works by interfacing with LuanRT's Botguard library to create tokens on demand. The plugin supports two operational modes: an HTTP server that runs continuously and generates tokens on request (faster, recommended), or a script that spawns a new process for each token generation (slower, higher overhead). Installation requires setting up the token provider separately—either via Docker, Node.js, or Deno—before installing the plugin itself into yt-dlp's plugin directory. No token generation is guaranteed; YouTube's bot checks evolve, and this tool may not work in all scenarios. Use it for: - Download videos from a residential or flagged IP address that YouTube has marked as suspicious. - Automate video downloads in scripts or services where interactive sign-in is not feasible. - Run yt-dlp in a Docker container or CI/CD environment where YouTube bot checks are common. - Maintain a persistent token cache to reduce latency when downloading multiple videos in succession. - Integrate proof-of-origin authentication into a custom video archival or monitoring system. ## Worth the install? AI-flagged interpretation of the facts above — verify before relying. A yt-dlp plugin that provides proof-of-origin tokens to help bypass YouTube's bot-detection checks when downloading videos from flagged IP addresses. Yes, if you regularly download videos from a flagged IP and yt-dlp is already your download tool. The plugin is low-friction to install, actively maintained, and has no Python dependencies. However, it requires separate setup of a Node.js or Deno backend, and token generation is not guaranteed to bypass all YouTube checks—treat it as a potential workaround, not a reliable solution. Not necessary if your IP is not flagged or if you can sign in interactively. ## Install pip install bgutil-ytdlp-pot-provider uv add bgutil-ytdlp-pot-provider poetry add bgutil-ytdlp-pot-provider ## Installing bgutil-ytdlp-pot-provider Before you install: Low friction: pure Python wheel with no runtime dependencies. Actively maintained as of March 2026. Requires yt-dlp 2025.05.22 or above, and either Node.js (≥20) or Deno (≥2.0.0) to run the token generation backend separately. License in practice: Licensed under GPLv3 (copyleft). Any modifications or derivative works must be released under the same license; commercial use is permitted but source code must remain available. Quickstart: pip install -U bgutil-ytdlp-pot-provider # Set up the HTTP server (option a, recommended): git clone --branch 1.3.1 https://github.com/Brainicism/bgutil-ytdlp-pot-provider.git cd bgutil-ytdlp-pot-provider/server/ npm ci && npx tsc node build/main.js # Then use yt-dlp normally; the plugin auto-provides tokens Requires yt-dlp 2025.05.22 or above, Node.js (≥20) or Deno (≥2.0.0), and git to clone the provider repository. The HTTP server runs on port 4416 by default. Verify before relying: - Whether the token generation actually succeeds for all YouTube regions and account states, or only for specific IP-flagging scenarios. - Performance impact of token generation on yt-dlp download speed when using the script method versus the HTTP server. - Reliability of the cache mechanism (6-hour default TTL) under concurrent yt-dlp invocations. ## Package facts - License: not declared (copyleft) - Python support: supports_current - Install friction: low - Maintenance: active - Downloads: 724.4K/month (top 15,000 on PyPI) - Known vulnerabilities: none known ## Tags yt-dlp pot provider, youtube proof of origin token, yt-dlp bot detection bypass, youtube video download authentication, yt-dlp bgutil provider, proof of origin token generator, yt-dlp 403 error workaround, yt-dlp-plugin, video-download, authentication [View on SkillFed](https://skillfed.io/packages/bgutil-ytdlp-pot-provider) · [View on PyPI](https://pypi.org/project/bgutil-ytdlp-pot-provider/)