Skip to content

Commit

Permalink
Readme update
Browse files Browse the repository at this point in the history
  • Loading branch information
jerryn70 authored Aug 16, 2020
1 parent 9c0838e commit 7d90060
Showing 1 changed file with 127 additions and 0 deletions.
127 changes: 127 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
<p align="center">
<img width="460" height="220" src="https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Images/GoodbyeAds.png">
</p>
<br>
[![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)
<a href="https://github.com/jerryn70/GoodbyeAds"><img alt="Code style: black" src="https://img.shields.io/badge/build%20-passing-32CD32.svg"></a>
<a href="https://github.com/jerryn70/GoodbyeAds"><img alt="Code style: black" src="https://img.shields.io/badge/status%20-stable-FF1493.svg"></a>
<a href="https://github.com/jerryn70/GoodbyeAds"><img alt="Code style: black" src="https://img.shields.io/badge/updated%20on-16 Aug 2020-9400D3.svg"></a>
<h1 align="center">GoodbyeAds - W🌎rld of Ads Free Internet</h1>
<p align="center">
<a href="https://paypal.me/jerryn70" target="_blank"><img alt="Donate using Paypal" src="https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif"></a>
&nbsp;&nbsp;
<a href="https://liberapay.com/jerryn70/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>
</p>

<p align="center">
<strong>Blocks Ads.Trackers.Analytics.Malware</strong>
</p>

<p align="center">
<h3>
<a href="https://t.me/GoodbyeAds">
Telegram
</a>
<span> | </span>
<a href="https://forum.xda-developers.com/android/software-hacking/goodbye-ads-advanced-protection-ads-ad-t3827269">
XDA
</a>
<span> | </span>
<a href="https://goodbyeads.weebly.com">
Website
</a>
</h3>
</p>

## 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.

<a href="https://paypal.me/jerryn70" target="_blank"><img width="200" height="100" src="https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Images/Paypal.png"></a>
<a href="https://liberapay.com/jerryn70/donate" target="_blank"><img width="200" height="100" src="https://raw.githubusercontent.com/jerryn70/GoodbyeAds/master/Images/LiberaPay.png"></a>

## 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).

0 comments on commit 7d90060

Please sign in to comment.