NetGuard/ADBLOCKING.md

65 lines
2.9 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
* 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-09-26 07:41:14 +00:00
<br />
2016-09-26 07:38:17 +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
* the test page only works using the hosts file downloaded from [here](https://www.netguard.me/hosts) (the default)
2016-04-10 16:34:54 +00:00
* 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-09-27 04:36:48 +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
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-09-26 07:41:14 +00:00
<br />
2016-09-26 07:38:17 +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-09-26 07:41:14 +00:00
<br />
2016-09-26 07:38:17 +00:00
Which hosts (ad servers) will be blocked depends on the hosts file being used.
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
<br />
2016-09-27 04:36:48 +00:00
Automation:
2016-09-26 07:38:17 +00:00
2016-09-27 04:36:48 +00:00
You can automatically download a hosts file by sending this service intent with your favorite automation tool, like Tasker:
2016-09-26 07:38:17 +00:00
2016-09-27 04:36:48 +00:00
`eu.faircode.netguard.DOWNLOAD_HOSTS_FILE`
2016-09-26 07:38:17 +00:00
2016-09-27 04:36:48 +00:00
For example using [adb](https://developer.android.com/studio/command-line/adb.html) from the command line:
2016-03-20 13:58:22 +00:00
2016-09-27 04:36:48 +00:00
`adb shell am startservice -a eu.faircode.netguard.DOWNLOAD_HOSTS_FILE`
2016-08-28 08:35:41 +00:00
2016-09-26 07:41:14 +00:00
<br />
2016-08-28 08:35:41 +00:00
Apart from using a hosts file, you can block most in-app ads by blocking this address for Google Play services:
*googleads.g.doubleclick.net/443*
2016-09-16 12:21:57 +00:00
2016-09-26 07:41:14 +00:00
<br />
2016-09-26 07:38:17 +00:00
2016-09-16 12:21:57 +00:00
**Please do not mention this feature in Google Play store comments, since Google does not allow ad blocking applications in the Play store.**