https://github.com/code-charity/youtube
[top~1 open YouTube & Video browser-extension] - Enrich your experience & choice! 🧰180+ options & clever features 📌set+forget📌Longest-standing(been tough). Please join🧩us👨👩👧👧 ..⋮ {playback|content discovery|player|extra buttons|distractions|related videos|shorts|ads|quality|codec|full tab|full screen}
https://github.com/code-charity/youtube
addon chrome-extension css3 entertainment extension playback-speed player productivity subtitles video webextension youtube youtube-api youtube-channel youtube-player youtube-playlist
Last synced: 6 months ago
JSON representation
[top~1 open YouTube & Video browser-extension] - Enrich your experience & choice! 🧰180+ options & clever features 📌set+forget📌Longest-standing(been tough). Please join🧩us👨👩👧👧 ..⋮ {playback|content discovery|player|extra buttons|distractions|related videos|shorts|ads|quality|codec|full tab|full screen}
- Host: GitHub
- URL: https://github.com/code-charity/youtube
- Owner: code-charity
- License: other
- Created: 2018-03-02T10:05:24.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-11T02:28:28.000Z (6 months ago)
- Last Synced: 2025-05-11T03:28:13.857Z (6 months ago)
- Topics: addon, chrome-extension, css3, entertainment, extension, playback-speed, player, productivity, subtitles, video, webextension, youtube, youtube-api, youtube-channel, youtube-player, youtube-playlist
- Language: JavaScript
- Homepage: http://improvedtube.com
- Size: 10.7 MB
- Stars: 3,754
- Watchers: 274
- Forks: 605
- Open Issues: 879
-
Metadata Files:
- Readme: .github/README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- trackawesomelist - ImprovedTube (⭐3.6k)
README
(
)[
](https://github.com/code-for-charity/ImprovedTube-for-YouTube/releases/latest "Release.zip")
Report a bug ·
Wish a feature ·
Contribute ·
Donate · [Test🧪](https://github.com/code-for-charity/ImprovedTube-for-YouTube/archive/refs/heads/master.zip "Latest.zip")
/ImprovedTube/ a powerful but lightweight extension,
to enrich your video experience & enable your content selection.
Top 50
g 
'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 [📣
-
**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 more info on how to contribute, see the contribution wiki or #development
Please join us! And let's re-define "extensions"!
(Why are they often unfunded & neglected?)
🏷️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
CN(zh_CN) :
niceRAM
ausers
CN(zh_TW) :
Still34
water903
suitangi
ES :
Kioraga
Compvictor
dimateos
DMCS20
HI :
monishamandal02
BRAVO68WEB
FR :
leghort
Eymiks
Solvabl
AR :
Raayib
BN :
BRAVO68WEB
RU :
qweered
alexesprit
pt_BR :
dthiago
Mike-Correa
DavidBrazSan
unnamed-orbert :)
PT :
DrNopt
unnamed-orbert
ID :
Bagus23
A.Muttaqin
DE :
Termuellinator
css-smueller
JA :
utuhiro78
TR :
onurdumangoz
decimaldreamer
VN :
zeref-dragneel
KO :
msc9533
LYHyoung
(Iranian) Persian :
AC Lover
IT :
urfausto
FedericoSlongo
❌TH Thai :
______(You?)
PL :
FluidExtractor
❌Ukrainian
(You?)
❌Hebrew
(You?)
❌Czech
(You?)
SE :
KiloBravoBFE
NL :
aron-hoogeveen
Vistaus
RO :
hateofhades
SI :
AshenNethsara
EL(Greek) :
molyvius
❌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?)
- ...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
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/)
##### 💡 Vision for Open-Source Efficiency: 🌱 [`Auto Contributors`](https://github.com/code4charity/Open-Source-Bot--Github-Git-Pull-Request-Bot)
(Compare: Wikipedia Bots. Would especially help medium-size projects.) (+[list of regEx](https://github.com/code4charity/the-RegEx-Collector--Queries--Patterns " - ")?)
##### 💡 Vision for the _(tweaking-/userStyle-/"modding-"_)Community:
We can optimize the www's GUI, greatly prioritized: [Crowd Fixes](https://github.com/code-charity/Universal-UserTweaks)
( "insteada just tweakin@home like Sisyphos" )
##### 💡 Got great ideas? - Notify us? - [github/**Wish-Factory**](https://github.com/code-for-charity/wish-factory "💡") (or ideas@improvedtube.com)
🎁Our Extensions:
**Superb:** [**History Manager**](https://chrome.google.com/webstore/detail/unblob-alpha/odognhgojidbcgconbcipmgffjcmfaoj)
**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)
Research: [Ultimate Regex](https://chrome.google.com/webstore/detail/regex-search/pmihaiejckejbpjdnildimfkpcpnohlo)("Ctrl+F+Shift")[](https://github.com/code-for-charity/regex) ([`Regex Replace`](https://chrome.google.com/webstore/detail/regex-replace/ihcaaefaoebbcklmolaflgllidfamfgm))
**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!") (Equalizer[](https://github.com/code-for-charity/equalizer))
Home: (Start Page tabs ), [`TextEditor`](https://chrome.google.com/webstore/detail/text-editor/bnbgafdjiinlgnjaedmfaablklnafpka) [](https://github.com/code-for-charity/Editor), [`ToDo`](https://chrome.google.com/webstore/detail/to-do/mniboiicchcpkffcdlaocnkfpbdihgii)[](https://github.com/code-for-charity/todo)
**Development:** [**`Satus`**](https://github.com/code-for-charity/satus) (Our JS library) | [`WebGL.js`](https://github.com/code-for-charity/webgl.js) - WebGL Library
[endless grid](https://github.com/code-for-charity/pluviam), [CodeEditor](https://github.com/code-for-charity/code-editor), [TE](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**
**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
📟 "ImprovedTube Ticker 2022" /Pinned Issues
###### ❔[**ImprovedTube controls
❔[**Meaningful/Most similar extensions
📟 We are focused on updates, bugs & UX but please keep up your wishes for Features!♡
📟 Enjoy **our projects: global** [**Dark Mode
📟 **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
|[
](https://brave.com)Brave | [
](https://github.com/chromium/chromium)Chromium | [
](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