diff --git a/README.md b/README.md new file mode 100644 index 0000000..7076679 --- /dev/null +++ b/README.md @@ -0,0 +1,127 @@ +

+ +

+
+ +[![latest release](https://img.shields.io/github/release/jerryn70/GoodbyeAds.svg)](https://github.com/jerryn70/GoodbyeAds/releases) +[![license](https://img.shields.io/github/license/jerryn70/GoodbyeAds.svg)](https://github.com/jerryn70/GoodbyeAds/blob/master/license.txt) +[![contributors](https://img.shields.io/github/contributors/jerryn70/GoodbyeAds.svg)](https://github.com/jerryn70/GoodbyeAds/graphs/contributors) +[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black) +[![commits since last release](https://img.shields.io/github/commits-since/jerryn70/GoodbyeAds/latest.svg)](https://github.com/jerryn70/GoodbyeAds/commits/master) +[![last commit](https://img.shields.io/github/last-commit/jerryn70/GoodbyeAds.svg)](https://github.com/jerryn70/GoodbyeAds/commits/master) +[![commit activity](https://img.shields.io/github/commit-activity/y/jerryn70/GoodbyeAds.svg)](https://github.com/jerryn70/GoodbyeAds/commits/master) +Code style: black +Code style: black +Code style: black +

GoodbyeAds - W🌎rld of Ads Free Internet

+

+ Donate using Paypal +    + Donate using Liberapay +

+ +

+ Blocks Ads.Trackers.Analytics.Malware +

+ +

+

+ + Telegram + + | + + XDA + + | + + Website + +

+

+ +## Features + +- __small in size:__ The complete host list size is less then 2mb. +- __designed for mobile phones:__ Goodbye ads is specially designed for blocking ads in apps and mobile websites. +- __hosts based:__ based on `Hosts` file, all the bad stuffs blocked with `0.0.0.0` +- __any device:__ compatible with all devices, regardless of OS. +- __blockings:__ strictly blocks `advertisements, malwares, spams, statistics & trackers` on both web browsing and applications. +- __speed you need:__ reduces page loading time upto `half` of its actual time! +- __privacy:__ with all these annoyances blocking, it also `increases` privacy. +- __saves expense:__ greatly decreases data consumption `saving` expense. +- __clean:__ no `extra` bullshit! + +## What is a host file? + + A hosts file, named hosts, is a plain-text file used by all operating systems to map hostnames to IP addresses. Host file preferred over DNS so if a domain name is resolved by the hosts file, the request never leaves your computer. + +## Notice + +- We block **`graph.facebook.com`**. The reason is that this domain serves many of the ads. So, in order to use Facebook, you should consider to `whitelist either facebook's main app, or whitelist graph.facebook.com in your ad blocker` — **otherwise the Facebook app will not work** (there are no problems with facebook lite app and other facebook client apps). If you are using `Facebook lite messenger`, then `whitelist the app or whitelist mqtt-mini.facebook.com`. Otherwise messenger will not work. We always recommend our users to use Open Source Facebook Clients for 100% ad free experience. If you are facing any problems feel free to contact us through XDA or Telegram. + +- GoodbyeAds-Ultra Discontinued. + +## Packs + +Basic info about all GoodbyeAds packs. + +| PACK NAME | DESCRIPTION | BEST USE DEVICE | UNIQUE ENTRIES | HOSTS TXT | ADBLOCK FILTER | +|:---------:|:-------:|:---------:|:--------------:|:---------:|:--------------:| +GoodbyeAds | Block Ads.Trackers.Analytics.Malware. (Included Xiaomi Adblock & Samsung Adblock list) | Any Device | 194000+ | [TXT](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Hosts/GoodbyeAds.txt) | [FILTER](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Formats/GoodbyeAds-AdBlock-Filter.txt) | +GoodbyeAds YouTube Adblock | Special List to block YouTube Ads,Trackers & Analytics. | Mobile Phones, Computers, Smart Tv | 97602 | [TXT](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Extension/GoodbyeAds-YouTube-AdBlock.txt) | [FILTER](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Formats/GoodbyeAds-YouTube-AdBlock-Filter.txt) | +GoodbyeAds Xiaomi AdBlock | Special List to Block Xiaomi Ads,Trackers & Analytics. | Xiaomi Device | 276 | [TXT](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Extension/GoodbyeAds-Xiaomi-Extension.txt) | +GoodbyeAds Samsung Adblock | Special List to Block Samsung Ads,Trackers & Analytics. | Samsung Mobile/Smart Tv | 83 | [TXT](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Extension/GoodbyeAds-Samsung-AdBlock.txt) | +GoodbyeAds LeEco AdBlock | Special List to Block LeEco Ads,Trackers & Analytics. | LeEco Device | 110 | [TXT](https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Extension/GoodbyeAds-LeEco-Extension.txt) | + +## Supported Adblockers + +***Windows:*** On Windows, you can use [`Hostman`](http://www.abelhadigital.com/hostsman/), to get the best Windows Hosts Usage Experience. Make sure to disable DNS Client Service. + +***Android:*** For non-rooted devices, GoodbyeAds can be used with [`DNS66`](https://f-droid.org/en/packages/org.jak_linux.dns66/),or [`Blokada`](https://f-droid.org/en/packages/org.blokada.alarm/), or [`Personal DNS Filter`](https://www.zenz-solutions.de/personaldnsfilter/) or [`Nebulo`](https://nebulo.app/source) all are free and open-source ad-blockers. + +***Android (rooted):*** For rooted device, GoodbyeAds can be used with [`AdAway`](https://f-droid.org/en/packages/org.adaway/), a free and open-source ad-blocker for Android. + +***Linux:*** An open-source host file manager called [`hBlock`](https://github.com/hectorm/hBlock). + +***Mac OS:*** This host file can be used with [`gasmask`](https://github.com/2ndalpha/gasmask). + +***Adblockers:*** Use filter format with [`uBlock`](https://github.com/gorhill/uBlock), [`AdGuard`](https://adguard.com/en/welcome.html) or any other extension, software & app. + +## Package Sources + +Sources each pack uses. + +| PACKAGE | SOURCES | +|:-------:|:-------:| +**GoodbyeAds** | *GBA Core + 280blocker., Coinblocker domain list, Spam 404, Ad-war, Adguard Mobile Ads & filter, Anti pop ads, Blackbook, Zeus tracker, Adaway, AnudeepND, Ador's core hosts list, YHosts, Pishing bad sites, Cameleon hosts, Jiffxtremeblock, Userreports, Adguard Mobile adservers, Adguard mobile specefic & Spyware (Mobile-Host), Easylist Adservers, Easy Privacy, Easylist lite, add.207Net, add.Dead,add.Risk, add.Spam, Notrack trackers,MobileAdTrackers, Snuff hosts, MVPS.ORG, Steven Black Hosts, Someonewhocares, HpHosts, Streaming Ads, UncheckyAds, , PGL YoYo.org, .*| +**Xiaomi AdBlock** | *GBA Core + User reports , GBA Community* | +**LeEco AdBlock** | *GBA Core + User reports , GBA Community* | +**Samsung AdBlock** | *GBA Core + User reports , GBA Community* | +**YouTube AdBlock** | *GBA Core + User reports , GBA Community* | + +## Documentation + + - [FAQ](https://github.com/jerryn70/GoodbyeAds/blob/master/Docs/FAQ.md) + - [How to Use](https://github.com/jerryn70/GoodbyeAds/blob/master/Docs/How%20to%20use.md) + - [Sources](https://github.com/jerryn70/GoodbyeAds/blob/master/Docs/Sources.md) + - [Dead Hosts Removal](https://github.com/jerryn70/GoodbyeAds/blob/master/Docs/Dead%20host%20removal.md) + +## Support + +Maintaining a quality blocking project takes a lot of time. GoodbyeAds is completely independently funded. We fight for our users. This does mean +however that we also have to spend our owns to pay the bills. This is where you can help: by chipping in you can ensure more time is spent improving GoodbyeAds rather than dealing with distractions. + +This donation is for our services, not for any pack, resource or any other mean. Your support will help us keep the project running and provide you quality service. + + + + +## Disclaimer + +Goodbye Ads Hosts are basically `hosts` files to block access to domains. If you don't know how it works, then please try this at your own risk. I won't be responsible for any damage or loss. Never forget to make backups. + +## License + +Content of the GoodbyeAds is licensed under a [MIT License](https://github.com/jerryn70/GoodbyeAds/blob/master/LICENSE). +