# Technical Documentation: code-charity/youtube > ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/code-charity/youtube) ### Overview (`.github/README.md`)

/ImprovedTube/ a powerful but lightweight extension,
to enrich your video experience & enable your content selection.

Top 50

'Might
be the only YouTube Extension you'll ever need'
'enhances YouTube in meaningful ways'
'Strong Add-on, full control. Yet clear & easy'
Thanks ♡ to our contributors, Alan Tan, Raszpl
translators (+ wiki-authors? +donators?):bowtie:

Original introduction

«Improve YouTube!»

/ImprovedTube/ is a strong & lightweight extension! - 80 features / the only one of a kind!

Since 2012 we have gradually been adding lightweight features, while keeping up with Youtube changes. (throughout the years we witnessed the birth & fall of other promising & open YouTube Extensions [1](https://github.com/YePpHa/YouTubeCenter "YouTubeCenter"), [2](https://github.com/ParticleCore/Iridium "Iridium"), ... ) Today adding features can be easier & so motivating as there are 500 000 users. [[👪Join us]](https://github.com/code-for-charity/YouTube-Extension/discussions/1006 "github.com/Code-for-Charity").

#####

Spread the word [📣](Http://Twitter_Whatsapp_Discord_Youtube_Facebook_eMail_Telegram_Signal)

- **W**hy arent there millions of users yet? We didn't write a guide or manual, let alone ads. This project can "fly much higher" through your word of mouth & eventually enable us to work on all wishes & immediate fixes around the clock🌱

## **Contributing** For info on how to contribute, see the wiki or #development

Please join us! Let's redefine "Browser extensions"!

`🏷️`Roadmap

- [ ] _Find [developers](https://github.com/code-charity/youtube/discussions/1881), patreons_ - - [ ] _All [bugs](https://github.com/code4charity/YouTube-Extension/issues?q=label%3Abug+sort%3Acomments-desc+is%3Aopen+-label%3A_+), many [wishes](https://github.com/code4charity/YouTube-Extension/issues?q=label%3A%22Feature+Request%22+sort%3Acomments-desc+is%3Aopen+-label%3A_++-label%3A%22not+Goo.+Chrome%22+)_ - [ ] _Documentation, tooltips_ - - [ ] _Tags for our search (multilanguage)_ - [ ] Continuously integrate awesome code: [YCS](https://github.com/sonigy/YCS)
[Userscripts](https://greasyfork.org/en/scripts?sort=total_installs#:~:text=HTML5%20Video), [Nova](https://github.com/raingart/Nova-YouTube-extension)?, [yr](https://github.com/MarcGuiselin/youtube-refined)filters or more([i](https://github.com/ThomasTavernier/Improve-Crunchyroll) [p](https://github.com/ppixiv/ppixiv) [r](https://github.com/refined-github/refined-github) [o](https://github.com/ovity/octotree),..) - - [ ] Smart Player-[buttons](https://github.com/code-for-charity/ImprovedTube-for-YouTube/issues/1445) for all \ - [ ] Clean YT's DOM? (+avoid CPU-rendering) - [ ] Smart [filtering /discovery](https://github.com/code-for-charity/ImprovedTube-for-YouTube/issues/1451), [YT.js](https://github.com/LuanRT/YouTube.js), [M](https://github.com/code-for-charity/ImprovedTube-for-YouTube/issues/1463), [D](https://github.com/code-charity/youtube/issues?q=is%3Aopen+sort%3Aupdated-desc+label%3A%22%3Cmeta%3E+data%22) - - [ ] Integrate data [#1452](https://github.com/code-for-charity/ImprovedTube-for-YouTube/issues/1452), [SB](https://github.com/mchangrh/sb-mirror) / [NB](https://github.com/andrewzlee/NeuralBlock) etc. - [ ] Full-page GUI: History & Dashboard - [ ] Consider m.youtube.com (grey-out some) - [ ] Ask Samsung Browser to list us Proofreaders :___ (You?)

Translators ♡ 🌎

✔️EN en_GB : Korbough
✔️UR : Faisal
FA : Neutron84
CN(zh_CN) : niceRAM ausers
FlootingDream Dovahseod
CN(zh_TW) : Still34 water903
suitangi
ES : Kioraga Compvictor dimateos
DMCS20
HI : monishamandal02 BRAVO68WEB
FR : leghort Eymiks Solvabl Tibood
AR : Raayib
BN : BRAVO68WEB
bn_BD : amitorko
RU : qweered alexesprit
pt_BR : dthiago Mike-Correa DavidBrazSan
unnamed-orbert :) pecazeco michellegalindo
PT : DrNopt unnamed-orbert drc-exe
ID : Bagus23 A.Muttaqin MoriMomo
DE : Termuellinator css-smueller
JA : utuhiro78
TR : onurdumangoz 0xUINTBEEF
VN : zeref-dragneel
KO : msc9533 LYHyoung yheedev
(Many users are korean! Thanks for caring!)
(Iranian) Persian : AC Lover
IT : urfausto FedericoSlongo
❌TH Thai : ______(You?)
PL : FluidExtractor
UK (Ukrainian) : vladyslavTEZYK
❌Hebrew : (You?)
❌Czech : (You?)
SE : KiloBravoBFE
NL : aron-hoogeveen Vistaus
RO : hateofhades
SI : AshenNethsara
EL(Greek) : molyvius
NE(Nepali) : prashant-sharma-cmd
❌DA Danish : (You?)
❌Hungarian : (You?)
❌FI Finnish : (You?)
❌Serbian : (You?)
❌Slovak : (You?)
❌BG Bulgarian : (You?)
no_NB : comradekingu
HR(Croatian) : mbeara
❌Croatian : (You?)
NO : master3395 comradekingu
SK : bbc-s
❌Catalan, Valencian : (You?)
❌Estonian : (You?)

[Help us Translate]

- ...Many popular languages are
spoken more / written less, but
please add yours!
(even if just a few words for fun.) Urdu Nigerian Pidgin (English Creole)
Western-&Eastern-Punjabi
Marathi(Indo-European)
✔️Telugu:Akhil3236
Tamil Yue Chinese (incl. Cantonese)
Tagalog(New name: Filipino)
Wu Chinese (incl. Shanghainese)
Hausa Egyptian Spoken Arabic
SwahiliJavaneseKannadaGujarati
Amharic Bhojpuri
Min Nan Chinese (incl. Hokkien),
Jin Chinese Yoruba Hakka Chinese
BurmeseMalayalam
Spoken Arabic: Sudanese Algerian
Lingala Malaysian Malay - Combined these have more 1st-language
speakers than English + Spanish + Hindi.
And more 2nd-language speakers than
Chinese + Hindi + Spanish.
(And there are so many more:
https://www.ethnologue.com/)

[Help us Translate]
(=here), or on Crowdin

💡 [**History Manager Extension**](https://chrome.google.com/webstore/detail/unblob-alpha/odognhgojidbcgconbcipmgffjcmfaoj)

🌱 [Wish-Factory](https://github.com/code-for-charity/wish-factory "💡") Got great/er ideas? ideas@improvedtube.com 🌱 [Crowd Fixes](https://github.com/code-charity/Universal-UserTweaks) - We can optimize the www's GUI and greatly prioritized. Instead of only tweaking some uBlock or Sylish rules for oneself (which is not always worth it for a single user, if something changes soon.) 🌱 [`Contributor Bot`](https://github.com/code4charity/Open-Source-Bot--Github-Git-Pull-Request-Bot) - Vision for Open-Source Efficiency. (Compare: Wikipedia Bots. Would especially help medium-size projects.) (+[list of regEx](https://github.com/code4charity/the-RegEx-Collector--Queries--Patterns " - ")?) 🌱 [List of new project plans / Ideas ](https://github.com/code-charity/List-of-Ideas/discussions/2); GSoC 2027? (Google summer of Code)

`🎁`Our Extensions:

**Global / Filters:**

[unFreeze me](https://chrome.google.com/webstore/detail/ctrl-f-freedom-%20-right-cl/ijngdimmjkngoglcjaheoadciaalbafl " Unlock your right-click, ctrl+F, selection anywhere")

[

](https://github.com/code-for-charity/unlock-keyboard-and-mouse)

[Dark Mode](https://chrome.google.com/webstore/detail/dark-mode/declgfomkjdohhjbcfemjklfebflhefl " - Universal dark-mode!")

[

](https://github.com/code-for-charity/dark-mode)
Productivity & research:
[

Ultimate Regex](https://chrome.google.com/webstore/detail/regex-search/pmihaiejckejbpjdnildimfkpcpnohlo)Regex-fix sites & "Ctrl+F+Shift"

[

](https://github.com/code-charity/ultimate-REGEX-extension/issues/4)
**Browser:** [`Custom user agent`](https://chrome.google.com/webstore/detail/custom-user-agent/ncgbkkljbaojkhljombpjejedphfhdjj)[

](https://github.com/code-for-charity/user-agent) [`auto-scroll`](https://chrome.google.com/webstore/detail/auto-scroll/kpfalbhnppkbokafignonoppegdndlch "(missing in Linux)")

**Video / Media:** (integrate them in this extension please)
[Looper](https://chrome.google.com/webstore/detail/looper/hlnfnoahfgnjnbkdckfnolacbmoknlmi)[

](https://github.com/code-for-charity/looper) [Frame by Frame](https://chrome.google.com/webstore/detail/frame-by-frame/cclnaabdfgnehogonpeddbgejclcjneh)[

](https://github.com/code-for-charity/frame-by-frame) [`unBlob`](https://chrome.google.com/webstore/detail/unblob-alpha/odognhgojidbcgconbcipmgffjcmfaoj)[

](https://github.com/code-for-charity/unblob "please fix/adopt me!")
Home: [

](https://github.com/code-for-charity/Editor), [`ToDo`](https://chrome.google.com/webstore/detail/to-do/mniboiicchcpkffcdlaocnkfpbdihgii)[

](https://github.com/code-for-charity/todo) , [`TextEditor`](https://chrome.google.com/webstore/detail/text-editor/bnbgafdjiinlgnjaedmfaablklnafpka)
**Development:** [**`Satus`**](https://github.com/code-for-charity/satus) (Our JS library); [`WebGL.js`](https://github.com/code-for-charity/webgl.js) Library

_more/later/old_

Start Page tabs

; ([`Regex Replace`](https://chrome.google.com/webstore/detail/regex-replace/ihcaaefaoebbcklmolaflgllidfamfgm)

); (~~Equalizer[](https://github.com/code-for-charity/equalizer)~~);
**Development:**

 to be re-uploaded: [endlessGrid](https://github.com/code-for-charity/pluviam), [CodeEdit](https://github.com/code-for-charity/code-editor) [ThemeEngine](https://github.com/code-for-charity/theme-engine),  [Viscum Player](https://github.com/code-for-charity/viscum-player)'video.js'?

👩‍💻

"Behind the scenes"

Do you need to run a popular extension, site, app or repo?
We'd love to help meaningful projects@improvedtube.com

🏝⛵🏕 To-Do & Maintenance:

`🏷️` Labels

(sorted/Filtered = Dynamic To-Do lists)

**0.** [ ] [**Bugs🐞**](https://github.com/code4charity/YouTube-Extension/issues?q=label%3Abug+sort%3Acomments-desc+is%3Aopen+-label%3A_+ "we aim to offer some bug-bounties. Please ask") (we try to offer some bug bounty. [Please ask](mailto:bugs@improvedtube.com?subject=TODO_BOUNTY_LINK "especially if you are at a cheap/poor place ❤️") .)
**1.** **[ ]** [**Documentation, wiki, screenshots, video, ...**](https://github.com/code-for-charity/YouTube-Extension/wiki "We need to help people learning as easily as possible about our 90+ features. (Drafts welcome. This will become 🛈tooltips in the extension too!") > We need to help people to learn as easily as possible about our [90+ features](https://github.com/ImprovedTube/ImprovedTube/wiki/Features). (Drafts welcome. This can become **🛈ToolTips** in the extension!")
+**[ ]**[Updating translations](https://github.com/code-for-charity/YouTube-Extension/wiki/Translation-HowTo " - some language files miss additions.") +**[ ]**proofreading [eng](https://github.com/ImprovedTube/ImprovedTube/blob/master/_locales/en/messages.json) **2.** [ ]

[**Plans / Specifications 🧩**](https://github.com/code-for-charity/ImprovedTube-for-YouTube/issues?q=is%3Aissue+sort%3Acomments-desc+is%3Aopen+label%3A%22%F0%9F%A7%A9Plan+ready%22++-label%3A%22not+Goo.+Chrome%22+ "often unique & relevant (special)")

**&** [ ] [**organizational Discussions**](https://github.com/code-for-charity/YouTube-Extension/discussions?discussions_q=category%3AToDo++category%3AOrganization+ "Future & Structure")
**3.** [ ] [**Feature Requests🌟🧚**](https://github.com/code4charity/YouTube-Extension/issues?q=label%3A%22Feature+Request%22+sort%3Acomments-desc+is%3Aopen+-label%3A_++-label%3A%22not+Goo.+Chrome%22+ "- sometimes easy / CSS") - sometimes easy / CSS
**+** [ ] [**Wishes in discussions**](https://github.com/code-for-charity/YouTube-Extension/discussions?discussions_q=-category%3AToDo+-category%3AOrganization+ "Wishes, Ideas, Questions, News")
**0.1. [ ]** Tidy: [(Rest/Unsorted 'issues')](https://github.com/code4charity/YouTube-Extension/issues?q=is%3Aissue+is%3Aopen+-label%3Abug+-label%3A%22Feature+Request%22+-label%3A%F0%9F%A7%A9Plan%20ready+-label%3A_+-label%3A%22not+Goo.+Chrome%22+sort%3Acreated-desc++-label%3A"Niche%2Frare+usecase%3F%2Ffun%3F"++-label%3Aunclear "Our github issues, which are not yet labled yet to appear in one of the ToDo-categories above") > Further reading: [***"Contributing without programming"***](https://github.com/ImprovedTube/YouTube-Extension/discussions/753) & [*"Our CSS, JavaScript, json"*](https://github.com/ImprovedTube/ImprovedTube/pull/371#issuecomment-669725163)

( ***outdated**)* (*Newcomers are [we](https://github.com/ImprovedTube/ImprovedTube/issues/387#issuecomment-664980078)lcome tho! We review all edits & love to collaborate*)

`Features 🧰⋮⚙️🎛️☕🎧🎞️🎬🔊📈🎨⏯️`

https://www.youtube.com/watch?v=SLfff7Kw_Xc

https://github.com/code-charity/youtube/wiki/Manual

- Fit Video to window, default resolution or pop-up player - Hiding distractions - Youtube Themes, Colors & night schedule - Video Repeat-, screenshot-, rotate-buttons - Customizable hotkeys / shortcuts

[List of Features]

---

📟 "ImprovedTube Ticker 2022" /Pinned Issues

###### ❔[**ImprovedTube controls** in, under or around the video player or cursor](https://github.com/code4charity/YouTube-Extension/issues/1445).
❔[**Meaningful/Most similar extensions**? Social-Fixer, Youtube Enhancer, Simplify, ...](https://github.com/code4charity/YouTube-Extension/issues/1016).
📟 We are focused on updates, bugs & UX but please keep up your wishes for Features!♡
📟 Enjoy **our projects: global** [**Dark Mode**](https://chrome.google.com/webstore/detail/dark-mode/declgfomkjdohhjbcfemjklfebflhefl), to tweak CSS everywhere + Theme engine in the making, ...
📟 **2021:** Firefox, Edge, Opera, Whale added (please try&rate)

📜Historic Introduction

[ImprovedTube](https://chrome.google.com/webstore/detail/improve-youtube-open-sour/bnomihfieiccainjcjblhegjgglakjdd), is an extension we built

to refine your YouTube experience. A powerful one-stop-shop with many features to enhance YouTube, yet liteweight. Be it a larger player or more tidy / studious YouTube UI, hiding distractions. And there was so much left to build and are many clever features to come still. ImprovedTube is designed with our own UI library: [Satus](https://github.com/code-for-charity/satus) (to manage your settings efficiently & create familiar apps/['cousins](https://chrome.google.com/webstore/detail/dark-mode/declgfomkjdohhjbcfemjklfebflhefl) easily.) Please spread the word: ImprovedTube is the only project of it's kind, because other open Youtube Extensions resigned. No other project provides so much CSS to adjust a website[🦄](https://github.com/search?q=stars%3A%3E700++size%3A%3E3000+++language%3ACSS++App+OR+Addon+OR+Extension+NOT+framework+NOT+apps&type=Repositories&s=updated&o=desc).

**Some ImprovedTube features**: - Video quality - Themes and customisation - Repeat-, screenshot-, rotate-buttons - Pop-up player - Ads management - Hide Cards and Annotations - Customise video page appearance (always expand description, hide related videos etc.) - Channel page customisations - Customisation of hotkeys/shortcuts - Statistics - Volume mixer _[Full list](https://github.com/ImprovedTube/YouTube/wiki/Features)_ **🔧 Install from source** 1.) **Download & extract the [[latest🧪version]](https://github.com/code4charity/YouTube-Extension/archive/refs/heads/master.zip) or [[release]](https://github.com/code-for-charity/YouTube-Extension/releases)** - **Safari**: - 2.) [Issue #494](https://github.com/code4charity/YouTube-Extension/issues/494#issuecomment-675098753) - **Chrome / Chromium / Brave / Edge / Vivaldi** - 2.) Go to your Browser's Extensions page (*chrome://extensions/*) - 3.) Activate `Developer mode` - 4.) Click the `Load unpacked` button & Select the extracted folder - **Firefox / LibreWolf / Waterfox / IceCat** - 2.) Go to `Add-ons` (*about:addons*) - 3.) Click on `Extensions` tab - 4.) Click on `Debug Add-ons` (*about:debugging#/runtime/this-firefox*) - 5.) Click on `Load Temporary Add-on…` - 6.) Select the `manifest.json` file from unzipped folder #### Web browser support |[ Brave

](https://brave.com)
Brave | [

](https://github.com/chromium/chromium)
Chromium | [ Chrome

](https://chrome.google.com/webstore/detail/improve-youtube-open-sour/bnomihfieiccainjcjblhegjgglakjdd)
Chrome | [

](https://www.microsoft.com/edge)
Edge | [

](https://foundation.mozilla.org)
Firefox | [

](https://addons.opera.com/en/extensions/details/install-chrome-extensions/)
Opera| [

](https://www.apple.com/safari/)
Safari | [

](https://github.com/ric2b/Vivaldi-browser)
Vivaldi | | --------- | --------- | --------- | --------- | --------- | --------- | --------- | --------- | | 0.52+ | 49.0+ | 49.0+ | 79.0+ | 44.0+ | 36.0+ | x.x+ | 1.0+ |

🔧 Installing from source

1.) **Download & extract the [[latest🧪version]](https://github.com/code4charity/YouTube-Extension/archive/refs/heads/master.zip) or [[release]](https://github.com/code-for-charity/YouTube-Extension/releases)** - **Safari**: - 2.) [**Build yourself**](https://github.com/code4charity/YouTube-Extension/issues/494#issuecomment-675098753) - OR - 2.) Right-click ImprovedTube.app and select the "Open" option from the drop down menu. - 3.) Run this extension in your Applications folder - 4.) Open System Settings, click Privacy & Security, scroll down, and click the Open Anyway button (Allow App Store and identified developers first) - 5.) Click Quit and Open Safari Settings... - 6.)Click Advanced in Safari Settings and then turn on Show Develop menu in menu bar - 7.) Click Develop in Safari menu bar and then turn on Allow Unsigned Extensions - If you’re using Safari 17 or later, click the Developer tab in Safari Settings, and select the “Allow unsigned extensions” option - The Allow Unsigned Extensions setting resets when a user quits Safari, so you need to set it again the next time you launch Safari. - 8.) Click Develop in Safari menu bar and then turn on Allow Unsigned Extensions - 9.) You will see this extension in Extensions of Safari Settings, turn on it - 10.) Click Always Allow on Every Website - **Chrome / Chromium / Brave / Edge / Vivaldi** - 2.) Go to your Browser's Extensions page (*chrome://extensions/*) - 3.) Activate `Developer mode` - 4.) Click the `Load unpacked` button & Select the extracted folder - **Firefox / LibreWolf / Waterfox / IceCat** - 2.) Go to `Add-ons` (*about:addons*) - 3.) Click on `Extensions` tab - 4.) Click on `Debug Add-ons` (*about:debugging#/runtime/this-firefox*) - 5.) Click on `Load Temporary Add-on…` - 6.) Select the `manifest.json` file from unzipped folder

--- --- METRICS --- - Files Extracted: 1 - Estimated Token Budget: ~10653 tokens - Canonical Reference: https://codewiki.google/github.com/code-charity/youtube

«Improve YouTube!»

🏷️Roadmap