From f50f31cfefa0e22c5b86471fb4e83c1d3c64de6c Mon Sep 17 00:00:00 2001 From: bmcdonough Date: Tue, 18 Nov 2025 15:29:45 +0000 Subject: [PATCH 1/3] document PO Token Provider URL --- mkdocs/docs/settings/application.md | 37 +++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/mkdocs/docs/settings/application.md b/mkdocs/docs/settings/application.md index 7a708b0..817f98e 100644 --- a/mkdocs/docs/settings/application.md +++ b/mkdocs/docs/settings/application.md @@ -168,6 +168,43 @@ There is only one cookie per Tube Archivist instance. This will be shared betwee ## PO Token Also known as _proof of origin token_, this is a token required in some cases by YT to validate the requests. See the wiki on the yt-dlp repo with more info, particularly the [PO Token Guide](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide) page. +## POT Provider URL +yt-dlp offers a [plugin](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide#po-token-provider-plugins) to support for the Proof of Origin (PO) Token. +In an effort to make it easier for the user, **Tube Archivist** has implemented the plugin: + +- [bgutil-ytdlp-pot-provider](https://github.com/Brainicism/bgutil-ytdlp-pot-provider) by [Brainicism](https://github.com/Brainicism) + +### Installation +The following is a suggested docker-compose.yml to use the plugin with the default **Tube Archivist** container. +The default container creates it's own network named tubearchivist_default. +Please customize this example to your needs. + +```yml +services: + bgutil-provider: + image: brainicism/bgutil-ytdlp-pot-provider + container_name: bgutil-provider + restart: unless-stopped + init: true + ports: + - "4416:4416" + environment: + - TZ=Etc/UTC + networks: + - tubearchivist_default + +networks: + tubearchivist_default: + external: true +``` + +### Configuration +If you are using the above example docker container for **bgutil-ytdlp-pot-provider**, here is an example of what the URL would be: + +```text +http://bgutil-provider:4416 +``` + ## Integrations All third party integrations of **Tube Archivist** will **always** be *opt in*. From 7dab96ca548e70ca8d1328617fd4033822ba2d4b Mon Sep 17 00:00:00 2001 From: bmcdonough Date: Tue, 18 Nov 2025 15:36:53 +0000 Subject: [PATCH 2/3] changed the wording PO Token Provider to match yt-dlp --- mkdocs/docs/settings/application.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs/docs/settings/application.md b/mkdocs/docs/settings/application.md index 817f98e..66505c2 100644 --- a/mkdocs/docs/settings/application.md +++ b/mkdocs/docs/settings/application.md @@ -168,7 +168,7 @@ There is only one cookie per Tube Archivist instance. This will be shared betwee ## PO Token Also known as _proof of origin token_, this is a token required in some cases by YT to validate the requests. See the wiki on the yt-dlp repo with more info, particularly the [PO Token Guide](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide) page. -## POT Provider URL +## PO Token Provider URL yt-dlp offers a [plugin](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide#po-token-provider-plugins) to support for the Proof of Origin (PO) Token. In an effort to make it easier for the user, **Tube Archivist** has implemented the plugin: From f9a9a02ca52f7757351af65da36c7a9b6402946b Mon Sep 17 00:00:00 2001 From: Simon Date: Fri, 23 Jan 2026 00:01:43 +0700 Subject: [PATCH 3/3] simplify installation instructions --- mkdocs/docs/settings/application.md | 23 +++++++---------------- 1 file changed, 7 insertions(+), 16 deletions(-) diff --git a/mkdocs/docs/settings/application.md b/mkdocs/docs/settings/application.md index 66505c2..eccf401 100644 --- a/mkdocs/docs/settings/application.md +++ b/mkdocs/docs/settings/application.md @@ -169,15 +169,12 @@ There is only one cookie per Tube Archivist instance. This will be shared betwee Also known as _proof of origin token_, this is a token required in some cases by YT to validate the requests. See the wiki on the yt-dlp repo with more info, particularly the [PO Token Guide](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide) page. ## PO Token Provider URL -yt-dlp offers a [plugin](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide#po-token-provider-plugins) to support for the Proof of Origin (PO) Token. -In an effort to make it easier for the user, **Tube Archivist** has implemented the plugin: +Instruct yt-dlp to automatically fetch PO tokens from a token provider. +- [yt-dlp docs](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide#po-token-provider-plugins) - [bgutil-ytdlp-pot-provider](https://github.com/Brainicism/bgutil-ytdlp-pot-provider) by [Brainicism](https://github.com/Brainicism) -### Installation -The following is a suggested docker-compose.yml to use the plugin with the default **Tube Archivist** container. -The default container creates it's own network named tubearchivist_default. -Please customize this example to your needs. +For a minimal installation use the provided docker container. Example: ```yml services: @@ -186,18 +183,12 @@ services: container_name: bgutil-provider restart: unless-stopped init: true - ports: - - "4416:4416" - environment: - - TZ=Etc/UTC - networks: - - tubearchivist_default - -networks: - tubearchivist_default: - external: true + expose: + - "4416" ``` +When in doubt, consult the upstream resources. + ### Configuration If you are using the above example docker container for **bgutil-ytdlp-pot-provider**, here is an example of what the URL would be: