Skip to content

New README #2711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
187 changes: 187 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,187 @@
# <img src="https://github.com/code-charity/youtube/blob/f466617897ad5d5dd2e2b88e3d0d195a702359b4/menu/icons/32.png"> ImprovedTube
**`ImprovedTube`** is a powerful but lightweight extension,
to enrich your video experience & enable your content selection.

**Downloads**:
[Chrome](https://chrome.google.com/webstore/detail/improve-youtube-video-you/bnomihfieiccainjcjblhegjgglakjdd)
[Safari](https://apps.apple.com/us/app/improved-tube/id1672777754)
[Firefox](https://addons.mozilla.org/en-US/firefox/addon/youtube-addon/)
[Edge](https://microsoftedge.microsoft.com/addons/detail/improve-youtube-video-/knbckijjjbmkjiagojjneoplbjilfllc)
[Whale](https://store.whale.naver.com/detail/npfgdbojchpofhjdleehaoddbmbonbpa)
[Opera](https://addons.opera.com/de/extensions/details/improvedtube-youtube-extension/)
[Github](https://github.com/code-charity/ImprovedTube-for-YouTube/releases/latest)

## Recommended by
- [Firefox](https://addons.mozilla.org/en-US/firefox/addon/youtube-addon/)
Recommended: *"We're talking about carefully curated gems that meet the highest standards
in security, functionality, and overall user experience"*
- [lifehacker.com](https://lifehacker.com/this-might-be-the-only-youtube-browser-extension-youll-1846575110)
*"This Might Be the Only YouTube Browser Extension You'll Ever Need"*
- [ghacks.net](https://www.ghacks.net/2021/03/26/improved-youtube-enhances-youtube-in-meaningful-ways/)
*"Improved YouTube! enhances YouTube in meaningful ways"*
- [Chris Titus Tech](https://christitus.com/improve-youtube/)
*"The ImprovedTube extension has been enhancing the YouTube experience for users across all browsers"*

<!-- - [chip.de](https://www.chip.de/downloads/Improve-YouTube-fuer-Chrome_183480435.html) -->

## Contributing
For more info on how to contribute, see the [contributing wiki](https://github.com/code-charity/ImprovedTube-for-YouTube/wiki/Contributing").

### 💡 Vision for Open-Source Efficiency: 🌱 [`Auto Contributors`](https://github.com/code-charity/Open-Source-Bot--Github-Git-Pull-Request-Bot)
(Compare: Wikipedia Bots. Would especially help medium-size projects.) <br>
(+[community-list of regEx](https://github.com/code-charity/the-RegEx-Collector--Queries--Patterns " - ")?)

### 💡 Vision for the _(tweaking-/userStyle-/"modding-"_)Community:
We can optimize things for the world, greatly prioritized: [<img src="github.png" height="18px">Crowd Fixes](https://github.com/code-charity/Universal-UserTweaks) <br> ( <i> "insteada just tweakin@home like Sisyphos" </i> )

### 💡 Got great ideas?
Please notify us if you have relavant (volunteer) work beyond this project! (or [email protected])
- [Wish-Factory](https://github.com/code-charity/wish-factory "💡")

### 🎁 Our Extensions:

#### Superb:
- [**History Manager<**](https://chrome.google.com/webstore/detail/unblob-alpha/odognhgojidbcgconbcipmgffjcmfaoj) <a href="https://github.com/code-charity/history-manager"><img src="github.png" height="18px"></a><br>

#### 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!") [<img src="github.png" height="18px">](https://github.com/code-charity/unlock-keyboard-and-mouse)
- [**Dark Mode**](https://chrome.google.com/webstore/detail/dark-mode/declgfomkjdohhjbcfemjklfebflhefl) - Universal dark-mode! [<img src="github.png" height="18px">](https://github.com/code-charity/dark-mode)

#### Research:
- [Ultimate Regex](https://chrome.google.com/webstore/detail/regex-search/pmihaiejckejbpjdnildimfkpcpnohlo)("Ctrl+F+Shift")[<img src="github.png" height="18px">](https://github.com/code-charity/regex)
- [Regex Replace](https://chrome.google.com/webstore/detail/regex-replace/ihcaaefaoebbcklmolaflgllidfamfgm)[<img src="github.png" height="18px">](https://github.com/code-charity/ultimate-REGEX-extension/issues/3)

#### Browser:
- [Custom user agent](https://chrome.google.com/webstore/detail/custom-user-agent/ncgbkkljbaojkhljombpjejedphfhdjj)[<img src="github.png" height="18px">](https://github.com/code-charity/user-agent)
- [auto-scroll](https://chrome.google.com/webstore/detail/auto-scroll/kpfalbhnppkbokafignonoppegdndlch) [<img src="github.png" height="18px">](https://github.com/code-charity/auto-scroll)

#### Video / Media: (integrate them in this extension please)
- [Looper](https://chrome.google.com/webstore/detail/looper/hlnfnoahfgnjnbkdckfnolacbmoknlmi)[<img src="github.png" height="18px">](https://github.com/code-charity/looper)
- [Frame by Frame](https://chrome.google.com/webstore/detail/frame-by-frame/cclnaabdfgnehogonpeddbgejclcjneh)[<img src="github.png" height="18px">](https://github.com/code-charity/frame-by-frame)
- [unBlob](https://chrome.google.com/webstore/detail/unblob-alpha/odognhgojidbcgconbcipmgffjcmfaoj)[<img src="github.png" height="18px">](https://github.com/code-charity/unblob "please fix/adopt me!") (<i><del>Equalizer[<img src="github.png" height="18px">](https://github.com/code-charity/equalizer)</del></i>)

#### Home:
- [Start Page tabs](https://github.com/code-charity/start-page)
- [TextEditor](https://chrome.google.com/webstore/detail/text-editor/bnbgafdjiinlgnjaedmfaablklnafpka)[<img src="github.png" height="18px">](https://github.com/code-charity/Editor)
- [ToDo](https://chrome.google.com/webstore/detail/to-do/mniboiicchcpkffcdlaocnkfpbdihgii)[<img src="github.png" height="18px">](https://github.com/code-charity/todo)

#### Development:
- [**Satus**](https://github.com/code-charity/satus) (Our JS library)
- [`WebGL.js`](https://github.com/code-charity/webgl.js) - WebGL Library
- [endless grid](https://github.com/code-charity/pluviam)
- [CodeEditor](https://github.com/code-charity/code-editor)
- [TE](https://github.com/code-charity/theme-engine)
- [Viscum Player](https://github.com/code-charity/viscum-player) - video.js?

## Roadmap ✔️
- [ ] _Find [developers](https://github.com/code-charity/youtube/discussions/1881) and patreons._
- [ ] _Many [bugs](https://github.com/code-charity/youtube-Extension/issues?q=label%3Abug+is%3Aopen+-label%3A_+) and [wishes](https://github.com/code-charity/YouTube-Extension/issues?q=label%3A%22Feature+Request%22+is%3Aopen)_
- [ ] _Documentation and 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)
- [youtube-refined](https://github.com/MarcGuiselin/youtube-refined) filters and 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-charity/ImprovedTube-for-YouTube/issues/1445) for all `<video>`s
- [ ] Clean YT's DOM? (and avoid CPU rendering)
- [ ] Smart [filtering/discovery](https://github.com/code-charity/ImprovedTube-for-YouTube/issues/1451), [YT.js](https://github.com/LuanRT/YouTube.js), [M](https://github.com/code-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-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
- [ ] Ask Samsung Browser to list us

## Translation ♡
<code>✔️ [EN](https://github.com/code-charity/youtube/blob/master/_locales/en/messages.json)</code><br>
<code>[en_GB](https://github.com/code-charity/youtube/blob/master/_locales/en_GB/messages.json) : [Korbough](https://github.com/Korbough)</code> Proofreaders:`(You?)`<br>
<code>[CN(zh_CN)](https://github.com/code-charity/youtube/blob/master/_locales/zh_CN/messages.json") : [niceRAM](https://github.com/niceRAM) [ausers](https://github.com/ausers)</code><br>
<code>[CN(zh_TW)](https://github.com/code-charity/youtube/blob/master/_locales/zh_TW/messages.json) : [Still34](https://github.com/Still34) [water903](https://github.com/water903) [suitangi](https://github.com/suitangi)</code><br>
<code>[ES](https://github.com/code-charity/youtube/blob/master/_locales/es/messages.json) : [Kioraga](https://github.com/Kioraga) [Compvictor](https://github.com/Compvictor) [dimateos](https://github.com/dimateos) [DMCS20](https://github.com/DMCS20)</code><br>
<code>[HI](https://github.com/code-charity/youtube/blob/master/_locales/hi/messages.json) : [monishamandal02](https://github.com/monishamandal02) [BRAVO68WEB](https://github.com/BRAVO68WEB)</code><br>
<code>[FR](https://github.com/code-charity/youtube/blob/master/_locales/fr/messages.json) : [leghort](https://github.com/leghort) [Eymiks](https://github.com/Eymiks) [Solvabl](https://github.com/Solvabl)</code><br>
<code>[AR](https://github.com/code-charity/youtube-Extension/blob/master/_locales/ar/messages.json) : [Raayib](https://github.com/Raayib)</code><br>
<code>[BN](https://github.com/code-charity/youtube/blob/master/_locales/bn/messages.json) : [BRAVO68WEB](https://github.com/BRAVO68WEB)</code><br>
<code>[RU](https://github.com/code-charity/youtube/blob/master/_locales/ru/messages.json) : [qweered](https://github.com/qweered) [alexesprit](https://github.com/alexesprit)</code><br>
<code>[pt_BR](https://github.com/code-charity/youtube/blob/master/_locales/pt_BR/messages.json) : [dthiago](https://github.com/dthiago) [Mike-Correa](https://github.com/Mike-Correa) [DavidBrazSan](https://github.com/DavidBrazSan) [unnamed-orbert](https://github.com/unnamed-orbert)</code><br>
<code>[PT](https://github.com/code-charity/youtube/blob/master/_locales/pt_PT/messages.json) : [DrNopt](https://github.com/DrNopt) [unnamed-orbert](https://github.com/unnamed-orbert)</code><br>
<code>[ID](https://github.com/code-charity/youtube/blob/master/_locales/id/messages.json) : [Bagus23](https://github.com/Bagus23) [A.Muttaqin](https://github.com/fdciabdul)</code><br>
<code>[DE](https://github.com/code-charity/youtube/blob/master/_locales/de/messages.json) : [Termuellinator](https://github.com/Termuellinator) [css-smueller](https://github.com/css-smueller)</code><br>
<code>[JA](https://github.com/code-charity/youtube/blob/master/_locales/ja/messages.json) : [utuhiro78](https://github.com/utuhiro78)</code><br>
<code>[TR](https://github.com/code-charity/youtube/blob/master/_locales/tr/messages.json) : [onurdumangoz](https://github.com/onurdumangoz) [decimaldreamer](https://github.com/decimaldreamer)</code><br>
<code>[VN](https://github.com/code-charity/youtube/blob/master/_locales/vn/messages.json) : [zeref-dragneel](https://github.com/zeref-dragneel)</code><br>
<code>[KO](https://github.com/code-charity/youtube/blob/master/_locales/ko/messages.json) : [msc9533](https://github.com/msc9533) [LYHyoung](https://github.com/LYHyoung)</code><br>
<code>[(Iranian) Persian](https://github.com/code-charity/youtube/blob/master/_locales/fa_IR/messages.json) : [AC Lover](https://github.com/AC-Lover)</code><br>
<code>[IT](https://github.com/code-charity/youtube/blob/master/_locales/it/messages.json) : [urfausto](https://github.com/urfausto) [FedericoSlongo](https://github.com/FedericoSlongo)</code><br>
<code>❌[TH Thai](https://github.com/code-charity/youtube/blob/master/_locales/th/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>[PL](https://github.com/code-charity/youtube/blob/master/_locales/pl/messages.json) : [FluidExtractor](https://github.com/FluidExtractor)</code><br>
<code>`❌`[Ukrainian](https://github.com/code-charity/youtube/blob/master/_locales/uk/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[Hebrew](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[Czech](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>[SE](https://github.com/code-charity/youtube/blob/master/_locales/sv/messages.json) : [KiloBravoBFE](https://github.com/KiloBravoBFE)</code><br>
<code>[NL](https://github.com/code-charity/youtube/blob/master/_locales/nl/messages.json) : [aron-hoogeveen](https://github.com/aron-hoogeveen) [Vistaus](https://github.com/Vistaus)</code><br>
<code>[RO](https://github.com/code-charity/youtube/blob/master/_locales/ro/messages.json) : [hateofhades](https://github.com/hateofhades)</code><br>
<code>[SI](https://github.com/code-charity/youtube/blob/master/_locales/si/messages.json) : [AshenNethsara](https://github.com/AshenNethsara)</code><br>
<code>[EL(Greek)](https://github.com/code-charity/youtube/blob/master/_locales/el/messages.json) : [molyvius](https://github.com/molyvius)</code><br>
<code>`❌`[DA Danish](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[Hungarian](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[FI Finnish](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[Serbian](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[Slovak](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[BG Bulgarian](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>[no_NB](https://github.com/code-charity/youtube/blob/master/_locales/nb_NO/messages.json) : [comradekingu](https://github.com/comradekingu)</code><br>
<code>[HR(Croatian)](https://github.com/code-charity/youtube/blob/master/_locales/hr/messages.json) : [mbeara](https://github.com/mbeara)</code><br>
<code>`❌`[Croatian](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>[NO](https://github.com/code-charity/youtube/blob/master/_locales/no/messages.json) : [master3395](https://github.com/master3395) [comradekingu](https://github.com/comradekingu)</code><br>
<code>[SK](https://github.com/code-charity/youtube/blob/master/_locales/sk/messages.json) : [bbc-s](https://github.com/bbc-s)</code><br>
<code>`❌`[Catalan, Valencian](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>
<code>`❌`[Estonian](https://github.com/code-charity/youtube/blob/master/_locales/____/messages.json) : [(You?)](https://github.com/????????)</code><br>

<div align="center">

[Help us translate](https://github.com/code-charity/YouTube-Extension/wiki/Translations)
here, or on [Crowdin](https://crowdin.com/project/1655556")
</div>

## Development
### 🔧 Install from source
1. **Download & extract the [[latest🧪version]](https://github.com/code-charity/youtube-Extension/archive/refs/heads/master.zip) or [[release]](https://github.com/code-charity/YouTube-Extension/releases)**
- **Safari**:
- [Issue #494](https://github.com/code-charity/youtube-Extension/issues/494#issuecomment-675098753)

<details><summary>
`🔧` Installing on Safari </summary>

- 2.) [**Build yourself**](https://github.com/code-charity/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
</details>

- 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
|[<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/brave/brave_48x48.png" alt="Brave" width="28px" />](https://brave.com)</br>Brave | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chromium/chromium_48x48.png" alt="Chromium" width="28px" />](https://github.com/chromium/chromium)</br>Chromium | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" />](https://chrome.google.com/webstore/detail/improve-youtube-open-sour/bnomihfieiccainjcjblhegjgglakjdd)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="Edge" width="24px" height="24px" />](https://www.microsoft.com/edge)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](https://foundation.mozilla.org)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](https://addons.opera.com/en/extensions/details/install-chrome-extensions/)</br>Opera| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](https://www.apple.com/safari/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/vivaldi/vivaldi_48x48.png" alt="Vivaldi" width="24px" height="24px" />](https://github.com/ric2b/Vivaldi-browser)</br>Vivaldi |
| --------- | --------- | --------- | --------- | --------- | --------- | --------- | --------- |
| 0.52+ | 49.0+ | 49.0+ | 79.0+ | 44.0+ | 36.0+ | x.x+ | 1.0+ |
</details>
Loading