weyne/goodtube
1
0
Fork 0
mirror of https://github.com/goodtube4u/goodtube.git synced 2025-11-22 10:16:11 +00:00
Code Issues Packages Projects Releases Wiki Activity

Readme update

Browse Source
This commit is contained in:
unknown
2025-09-07 20:06:44 +10:00
parent 4c8846e425
commit 14e1474e81
1 changed files with 49 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files

80
README.md
View File

@@ -1,64 +1,82 @@
# GoodTube
Hello and welcome to GoodTube, a free adblocker for Youtube.<br>
This uses an alternative method to remove ads, which means it will still work even when traditional adblockers aren't working.
# GoodTube - Free Youtube Adblocker
**Hello and welcome to GoodTube, a free adblocker for Youtube.**
It also gives you an option to completely remove all shorts (this is turned on by default).
*This solution works in all browsers, including Google Chrome.*
It uses an alternative method to remove ads, which means it will continue to work even when other conventional adblockers such as uBlock Origin, AdGuard, Ghostery, Brave Browser, etc aren't working.
It also provides a few additional features -
- An option to completely remove all shorts (enabled by default).
- An option to hide info cards from videos.
- An option to hide end screen suggested videos.
## How to install
1. Install Tampermonkey (or any other userscript manager you like):<br>
https://www.tampermonkey.net/
2. For all browsers except Firefox - click the extensions icon up the top of your browser (the little puzzle piece icon), click "manage extensions", then on the screen that opens up the top you will find an option called "developer mode". You need to turn this on.
3. For all browsers except Firefox - click the extensions icon up the top of your browser (the little puzzle piece icon), click "manage extensions", click "Details" next to the "Tampermonkey" extension, enable the "Allow user scripts" option.
3. Visit this link and press install on the page that opens up:<br>
**1. Install Tampermonkey**<br>
Use this link to install for all browsers except Firefox<br>
https://chromewebstore.google.com/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo<br><br>
Use this link to install for Firefox<br>
https://addons.mozilla.org/en-US/firefox/addon/tampermonkey/
<br><br>
**2. Change browser settings (you can skip this if you're using Firefox)**<br>
Click the extensions icon up the top of your browser (the little puzzle piece icon), then click `Manage extensions`.<br><br>
At the very top of the page, there's an option called `Developer mode`. You need to turn this on.<br><br>
Now scroll down and click `Details` next to the Tampermonkey extension. Scroll down until you find the `Allow user scripts` option. You need to turn this on.
<br><br>
**3. Install GoodTube**<br>
Visit this link and press "Install" on the page that opens up:<br>
https://github.com/goodtube4u/goodtube/raw/refs/heads/main/goodtube.user.js
4. Restart your browser.
5. Turn off any other adblockers you're using, refresh, you should be good to go. You can leave your adlockers on for other websites, they just need to be turned off for Youtube.
This sounds more confusing than it is. If you're not technical YOU CAN DO IT. Just follow the steps as they're written. In a few minutes, you'll have it working :)
<br><br>
**4. Restart your browser**
<br><br>
**5. Turn off any other adblockers you're using on Youtube**<br>
You can leave your adlockers on for other websites, they just need to be turned off for Youtube. This is because they often trigger Youtube's adblock detection and this can cause issues.
<br><br>
*This install process sounds more confusing than it is. If you're not technical you can do it!! Simply follow the steps as they're written and in a few minutes, you'll have it working <3*
## FAQs
**Do I need to manually update this?**<br>
**Do I need to update this?**<br>
Nope, updates are pushed to you automatically so you don't have to do anything to use the latest version.
**Playlists skip to the next video every few seconds**<br>
This is usually caused by another adblocker which Youtube is detecting. To fix this problem, disable all of your other adblockers (for Youtube only, you can leave them on for other websites). Then clear your cookies and cache (this is important). Once that's done, refresh Youtube and the problem should be fixed.
This is usually caused by another adblocker which Youtube is detecting. To fix this problem, first disable all of your other adblockers (for Youtube only, you can leave them on for other websites). Then clear your cookies and cache (this is important). Once that's done, refresh Youtube and the problem should be fixed.
**I can't use the miniplayer**<br>
The Youtube miniplayer is not supported. Instead this uses "Picture in Picture" mode, which works in most browsers / is the new standard for the web. Unfortunately Firefox does not support the Picture in Picture API, so the button is removed in Firefox until they decide to include this feature.
The Youtube miniplayer is not supported. Instead this uses "Picture in Picture" mode, which is the new standard for the web. Unfortunately Firefox does not support the Picture in Picture API, so the button is disabled in Firefox until they decide to include this feature.
**I'm having a different problem**<br>
If you're having a different issue, most of the time you will find it's caused by a conflicting extension you have installed. The first thing to do is turn off literally every single other extension and userscript you have installed. Refresh Youtube, check if the problem is fixed. If it is, then you know something is conflicting. Turn your other extensions and userscripts back on one at a time until you find the cause. Please be sure to follow these steps before reporting an issue! As mentioned, it's almost always the root cause.
If you're having a different issue, most of the time you will find it's caused by a conflicting extension you have installed. The first thing to do is turn off all other extensions you have installed. Leave only Tampermonkey and GoodTube enabled. Then refresh Youtube, check if the problem is fixed. If it is, then you know one of them is causing the issue. Turn your other extensions back on back on one at a time until you find the problem.
## Why is removing these ads so important?
Youtube remains the _largest online archive of music and art in the world_ and without it a huge amount of timeless human content and history would be lost forever. It contains extremely important digitised versions of rare physical media such as records, films, etc - which can be accessed nowhere else.<br>
Youtube is currently the _largest online archive of music, art and educational videos in the world_.<br>
Youtube is also how most people on earth access free music, art, educational videos, entertainment, etc. The importance of allowing people to access these things cannot be overstated.<br>
The importance of allowing people to access these things for free cannot be overstated.<br>
This content is for _everyone_ and is not Youtube's to sell back to us. We must keep this content preserved for future generations and what's been happening lately is disgraceful.<br>
Youtube also contains rare and extremely important digitised versions of physical media such as records, films, etc - which can be accessed nowhere else. It is extremely important that we preserve this content for future generations.<br>
I see Youtube in the same capacity as a library or museam and as such hold them to the same standards. They have a social repsonsibility which is not being taken seriously. Many disadvantaged people cannot "just buy premium". A large portion of the world lives in extreme poverty. Many people have mental health conditions which are simply not conducive to "buying premium". These are just a few examples.<br>
This content is for _everyone_ and is not Youtube's to sell back to us. They did not create it, nor do they own it.<br>
Initially Youtube was completely free, which is why so much content was uploaded there in the first place. But in recent years, more and more commercial ads are being pushed on users. It's disgraceful honestly.<br>
I see Youtube in the same capacity as a library or museam and as such hold them to the same standards. They have a social repsonsibility which is not being taken seriously. I do not care what their terms of service say at all.<br>
Many disadvantaged people cannot buy premium. A large portion of the world lives in extreme poverty, even in first world countries. Many people have mental health conditions which are simply not conducive to "buying premium". These are just a few examples.<br>
This timeless human content belongs to everyone, not just the wealthy and privileged. It should not be disrespected with more and more commercial ads in this way.<br>
As a human being on this earth, with a heart, soul, mind and spirit - _you matter and are important_, despite these crazy times in which we live. _You are NOT simply a product to be bought and sold_ by capitalist companies such as Youtube.<br>
As a human being on this earth, with a heart, soul, mind and spirit - you matter and are important. You are not simply a product to be bought and sold by capitalist companies such as Youtube.<br>
Let's keep this important resource, everything on it and ourselves free.
This plugins helps to keep this important resource and everything on it 100% free for everyone.
## Make a Donation
**This adblocker is 100% free to use and always will be.<br>
It has helped over 90 thousand people remove the unbearable ads from Youtube.**
It has helped over 95,000 people remove the unbearable ads from Youtube.**<br>
Countless hours and late nights have gone into making this and I continue to work on updating and maintaining the project regularly. I remain dedicated to ensuring this solution continues to work for everyone (despite Youtube's best efforts to stop adblockers). If you have any issues at all, please let me know and I will do my best to help!<br>
This project has been made entirely by myself, as just one developer. Countless hours and late nights have gone into making this and I continue to work on updating and maintaining the project regularly. I remain dedicated to ensuring this solution continues to work for everyone (despite Youtube's best efforts to stop adblockers).<br>
Any donation, no matter how small, helps to keep this project going and supports the wider community who use it. If you would like to say "thank you" and give something back, it would be greatly appreciated.
Donations help to keep this project going and supports the wider community who use it. If you would like to say thank you and can give something back, it would be greatly appreciated.<br>
You can make a donation here:<br>
https://tiptopjar.com/goodtube