Koutube (ex YocksTube)

pronounced a bit like "cool tube"

Koutube is a web service, running in Cloudflare Workers, that fixes YouTube embeds on messenger platforms like Discord. It allows you to watch YouTube videos directly on Discord without opening a new tab or window.

Usage 💡

s/y/k

(sounds like SIKE very funny)

Features 🌟

• 📊 Displays likes, subscribers, publish/last update date, and view count on videos
• 📦 Public database listing on /
• ⏯️ Supports YouTube Music (music.koutube.com), including mixes
• Ⓜ️ Supports m.youtube.com
• 📱 Supports shorts
• 📺 Supports channels
• 🎶 Supports playlists
• 🤳 Supports livestreams
• 👎 Supports dislikes via RYD
• 🕔 Displays timecodes, including the format 1h2m3s
• ✔️ Displays channel verification
• 📲 Automatically opens the YouTube app on mobile
• 🎞️ Natively embeds videos on Discord
• 🌐 Easily improve youtu.be links using https://koutu.be
• 🚀 May bypass restrictions
• 🛡️ Removes tracking on redirects
• 🧪 (BETA) /img/ endpoint for generating embed images
• 💥 No random explosions (fixed!)

Caching 🚀

This project uses a 7-day cache of every URL that it processes to avoid hammering any services. Subject to change.
For image embeds, the cache is 1 year since I expect it to be used in more static applications.

I often clear the cache when I push a new update.

Parameters

• noCache - disables fetching the cached version
• nothumb to disable embedding the thumbnail, may help fix video cropping on mobile Discord clients
• shorts - treats the video as shorts
• dislikes - shows dislikes, requests from Return YouTube Dislike and is a bit slow
• itag - forces a specific video quality, only itag=22 for 720p and itag=18 for 360p are allowed

Example usage:

https://koutu.be/dQw4w9WgXcQ?nothumb&shorts

Note: remember URL param syntax, the first param is always defined by a question mark, the subsequent ones - by an ampersand.

Image Embeds 🖼️

This is an endpoint to generate embed images, for example for embedding into markdown. It renders the real YouTube embed as an image.

https://koutu.be/img/watch?v=dQw4w9WgXcQ

Params:

• ?size=hd720 - preset sizes:
• • small - 320x180
• • medium - 640x360
• • large - 854x480
• • hd720 - 1280x720
• • hd1080 - 1920x1080

Default is medium.

Demo:

[![Alt Text](https://koutu.be/img/watch?v=CpJSgoOD1-Y&size=small)](https://koutu.be/watch?v=CpJSgoOD1-Y)

Installation ⚙️

To install Koutube, you need to have Node and Cloudflare's wrangler tool installed on your system. You also need to have a Cloudflare account and enabled Workers, as well as a Workers KV database in Cloudflare. The Browser Rendering API is used for the image embed function.

To install wrangler, run the following command in your terminal:

npm install -g wrangler

Replace the binding in wrangler.toml with your own ID:

[[kv_namespaces]]
binding = "YT_CACHE_DB"
id = "your KV namespace ID" # <-- Replace This

Once you have everything set up, you can clone this repository and deploy Koutube to your own Workers domain.

git clone https://github.com/igerman00/koutube.git
cd koutube
npm i
wrangler deploy

You should see a message like this:

 ⛅️ wrangler 3.9.0
------------------
Total Upload: 7.10 KiB / gzip: 2.45 KiB
Uploaded Koutube (1.96 sec)
Published Koutube (1.43 sec)
  https://koutube.yourdomain.workers.dev
Current Deployment ID: 1234abcd-5678-efgh-9012-ijklmnopqrst

Now you can use Koutube by replacing https://www.youtube.com/watch?v= with https://koutube.yourdomain.workers.dev/watch?v= in any YouTube video URL and sending it to Discord.

---

Optional: Private Invidious Instance

Koutube is capable of working with a semi-private Invidious instance. All that is required for that is to define the secrets and Koutube will automatically pick your instance over every other.

To configure your own:

1. Follow the Invidious installation guide
2. Optionally restrict the instance to require an Authorization header Sidenote: /vi* and /latest_version* must be publicly accessible for Discord to validate the embed
3. Deploy secrets using Wrangler:

npx wrangler secret put IV_AUTH
# Follow the steps and enter your token value
npx wrangler secret put IV_DOMAIN
# Do the same but for your domain. For example, invidious.yourdoma.in

If you do not want to keep your instance private, you can either just add it in constants.ts or specify any authorization token value

If you want your secrets to be accessible during developement, create a file named .dev.vars and populate it as such:

IV_DOMAIN=invidious.yourdoma.in
IV_AUTH=YourTok3n

Development 🧑‍💻

To run Koutube locally for development, simply run:

wrangler dev

You should see a message like this:

⛅️ wrangler 3.9.0
------------------
wrangler dev now uses local mode by default, powered by 🔥 Miniflare and 👷 workerd.
To run an edge preview session for your Worker, use wrangler dev --remote
⎔ Starting local server...
[mf:inf] Ready on http://0.0.0.0:8787
╭─────────────────────────────────────────────────────────────────────────────────╮
│ [b open a       [d] open        [l] turn off local   [c] clear       [x] to     │
│   browser,         Devtools,       mode,                console,        exit    │
╰─────────────────────────────────────────────────────────────────────────────────╯

To manually purge the database, run:

npm run purge-db

This will remove all keys from the cache KV database

Note: if you have changed the binding name, you will also need to change it in scripts/purgeDb.js

License 📄

Koutube is licensed under the GPL-3.0 License.

Privacy 🔒

• The cache listing, which is a list of the vast majority of links processed by Koutube is public

• I try not to log anything I don't need, but I log some errors here and there and whenever a cached response is returned.

• A private Invidious instance is used for now due to unreliable public ones. No logging is configured

I have to actively enable log streaming by typing a command or logging into the Cloudflare dashboard. As you can imagine, I don't do that unless I am debugging an error.

Credits 👏

• @dylanpdx' vxtiktok for some embed template inspiration and bot user-agent list
• Invidious team for the easy-to-use API
• Return YouTube Dislike by @Anarios
• Cloudflare, for providing the free and easy-to-use serverless architecture and KV database API for this project