Advanced yt dlp plugins

Warning: Plugins can change underlying yt-dlp behavior that Pinchfork relies on. There is no guarantee Pinchfork will work correctly with arbitrary plugins installed.

---

The bgutil POT provider plugin

The bgutil POT provider yt-dlp plugin is already built into every Pinchfork image. You do not need to download, extract, or mount it. If you want PO Token support, add the bgutil sidecar container — that's all. See SABR Bypass and PO Tokens.

To confirm the plugin is loaded, run inside the container:

docker exec -it pinchfork yt-dlp --verbose 2>&1 | grep -i "extractor plugins"

---

Installing other plugins

For any plugin other than bgutil, use a Docker volume mount:

1. Map a host directory to /etc/yt-dlp/plugins in the container:

   volumes:
     - /path/to/config/extras/yt-dlp-plugins:/etc/yt-dlp/plugins

2. Download your plugin of choice and place it in that host directory. yt-dlp supports loading plugins from extracted directories or directly from .zip files — you do not need to extract the zip.
3. Restart the container.
4. Verify with docker exec -it pinchfork yt-dlp --verbose — look for the Extractor Plugins line.

See the yt-dlp plugin documentation for details on plugin directory layout.

Note: Mounting a host directory to /etc/yt-dlp/plugins will overlay the baked-in bgutil plugin. If you want to keep bgutil working alongside other plugins, include the bgutil zip in the same mounted directory.