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.
s/y/k
(sounds like SIKE very funny)
- 📊 Displays likes, subscribers, publish/last update date, and view count on videos
- 📦 Public database listing on /
- ⏯️ Supports YouTube Music (
music.koutube.com), including mixes Ⓜ️ Supportsm.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.belinks using https://koutu.be - 🚀 May bypass restrictions
- 🛡️ Removes tracking on redirects
- 🧪 (BETA)
/img/endpoint for generating embed images - 💥 No random explosions (fixed!)
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.
noCache- disables fetching the cached versionnothumbto disable embedding the thumbnail, may help fix video cropping on mobile Discord clientsshorts- treats the video as shortsdislikes- shows dislikes, requests from Return YouTube Dislike and is a bit slowitag- forces a specific video quality, onlyitag=22for 720p anditag=18for 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.
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
?size=hd720- preset sizes:-
small- 320x180
-
medium- 640x360
-
large- 854x480
-
hd720- 1280x720
-
hd1080- 1920x1080
Default is medium.
[](https://koutu.be/watch?v=CpJSgoOD1-Y)
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 wranglerReplace the binding in wrangler.toml with your own ID:
[[kv_namespaces]]
binding = "YT_CACHE_DB"
id = "your KV namespace ID" # <-- Replace ThisOnce 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 deployYou 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-ijklmnopqrstNow 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.
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:
- Follow the Invidious installation guide
- Optionally restrict the instance to require an
Authorization headerSidenote:/vi*and/latest_version*must be publicly accessible for Discord to validate the embed - 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.inIf you do not want to keep your instance private, you can either just add it in
constants.tsor 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=YourTok3nTo run Koutube locally for development, simply run:
wrangler devYou 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-dbThis 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
Koutube is licensed under the GPL-3.0 License.
-
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.
- @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