NetGuard/ADBLOCKING.md

42 lines
2.3 KiB
Markdown
Raw Normal View History

2016-03-20 10:32:07 +00:00
Ad blocking
-----------
2016-04-10 16:34:54 +00:00
Instructions:
2016-03-21 09:00:20 +00:00
* Download/install the latest NetGuard version [from GitHub](https://github.com/M66B/NetGuard/releases)
* Enable the setting '*Filter traffic*' in the advanced options (always enabled on Android 5.0 or earlier)
* Enable the setting '*Block domain names*' in the advanced options (default enabled)
* Import or download [a hosts file](https://en.wikipedia.org/wiki/Hosts_(file)) using the NetGuard backup settings
2016-03-20 13:58:22 +00:00
* Disable browser compression (Chrome: three dot menu > Settings > Data Saver > Off)
2016-03-20 10:32:07 +00:00
* Wait 10 minutes to let the Android DNS cache time out
2016-03-20 13:58:22 +00:00
* Test if it works by opening [this page](http://www.netguard.me/test)
2016-04-23 09:50:09 +00:00
* Enjoy ad blocking, but don't forget to support application developers in other ways
2016-03-20 10:32:07 +00:00
2016-04-10 16:34:54 +00:00
Note that:
* applications, like the browser, may cache data, so you might need to clear caches
* applications, browsers mostly, that have a *"data saver"* like feature that proxies requests through their servers (eg. Opera w/ Turbo, Opera Max app, Puffin, Chrome w/ data saver, UC Browser, Yandex w/ Turbo, Apus Browser, KK Browser, Onavo Extend, Maxthon) will not have ads blocked as NetGuard can't even see those domain requests
2016-04-10 16:34:54 +00:00
* the test page only works using the hosts file downloaded from [here](http://www.netguard.me/hosts) (the default)
* YouTube ads are not domain based and cannot be blocked
2016-07-01 06:03:57 +00:00
* NetGuard does not use the IP adresses in the hosts file, because it doesn't route blocked domains to localhost
2016-04-10 16:34:54 +00:00
* **ad blocking is not available when NetGuard was installed from the Play store!**
2016-03-20 13:58:22 +00:00
2016-04-22 05:50:03 +00:00
The NetGuard version from GitHub:
* is signed with the same signature as the version from the Play store, so any purchases will be restored
* will automatically notify you if there are updates (this can be switched off in the settings)
2016-04-23 09:50:09 +00:00
Which hosts (ad servers) will be blocked depends on the hosts file being used.
2016-03-20 10:32:07 +00:00
NetGuard provides the [StevenBlack hosts file](https://github.com/StevenBlack/hosts) download with the following additions:
* reports.crashlytics.com
* settings.crashlytics.com
* e.crashlytics.com
See [here](https://github.com/M66B/NetGuard/issues/277) for alternative hosts files.
2016-03-20 13:58:22 +00:00
NetGuard does not concatenate hosts files, so you will have to use a source which does this for you or do it yourself.
You can check the number of hosts (domains) imported by pulling the NetGuard notification down using two fingers.