From 6933daf0463e44b406b304c1ff78a0e832ed1e85 Mon Sep 17 00:00:00 2001
From: wukko <me@wukko.me>
Date: Sun, 20 Oct 2024 18:56:23 +0600
Subject: [PATCH] docs: add configure-for-youtube document

---
 README.md                     |  3 ++-
 docs/configure-for-youtube.md | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+), 1 deletion(-)
 create mode 100644 docs/configure-for-youtube.md

diff --git a/README.md b/README.md
index ca108a86..434b5943 100644
--- a/README.md
+++ b/README.md
@@ -32,9 +32,10 @@ this monorepo includes source code for api, frontend, and related packages:
 - [packages tree](/packages/)
 
 it also includes documentation in the [docs tree](/docs/):
+- [cobalt api documentation](/docs/api.md)
 - [how to run a cobalt instance](/docs/run-an-instance.md)
 - [how to protect a cobalt instance](/docs/protect-an-instance.md)
-- [cobalt api documentation](/docs/api.md)
+- [how to configure a cobalt instance for youtube](/docs/configure-for-youtube.md)
 
 ### partners
 cobalt is sponsored by [royalehosting.net](https://royalehosting.net/?partner=cobalt) and the main processing instance is hosted on their network. we really appreciate their kindness!
diff --git a/docs/configure-for-youtube.md b/docs/configure-for-youtube.md
new file mode 100644
index 00000000..345776a4
--- /dev/null
+++ b/docs/configure-for-youtube.md
@@ -0,0 +1,33 @@
+# how to configure a cobalt instance for youtube
+if you get various errors when attempting to download videos that are:
+publicly available, not region locked, and not age-restricted;
+then your instance's ip address may have bad reputation.
+
+in this case you have to use disposable google accounts.
+there's no other known workaround as of time of writing this document.
+
+> [!CAUTION]
+> **NEVER** use your personal google account for downloading videos via any means.
+> you can use any google accounts that you're willing to sacrifice,
+> but be prepared to have them **permanently suspended**.
+>
+> we recommend that you use accounts that don't link back to your personal google account or identity, just in case.
+>
+> use incognito mode when signing in.
+> we also recommend using vpn/proxy services (such as [mullvad](https://mullvad.net/)).
+
+1. if you haven't done it already, clone the cobalt repo, go to the cloned directory, and run `pnpm install`
+
+2. run `pnpm -r token:youtube`
+
+3. follow instructions, use incognito mode in your browser when signing in.
+i cannot stress this enough, but again, **DO NOT USE YOUR PERSONAL GOOGLE ACCOUNT**.
+
+4. once you have the oauth token, add it to your cookies file.
+you can see an [example here](/docs/examples/cookies.example.json).
+you can have several account tokens in this file, if you like.
+
+5. all done! enjoy freedom.
+
+### liability
+you're responsible for any damage done to any of your google accounts or any other damages. you do this by yourself and at your own risk.