NetGuard/README.md

# NetGuard

NetGuard is possibly the first free and open source no root firewall for Android.

<img src="screenshot.png" width="232" height="371" hspace="4"/>

Features
--------

* No root required
* Simple to use
* Free and open source
* No extra battery usage
* No calling home
* No tracking (analytics)
* No ads

NetGuard doesn't even require internet permission.

Usage
-----

* Enable the firewall using the switch in the action bar
* Allow/deny Wi-FI/mobile internet access using the icons at the right side of the application list

Permissions
-----------

* ACCESS_NETWORK_STATE: to check if the device is connected to the internet through Wi-Fi
* RECEIVE_BOOT_COMPLETED: to start the firewall when starting the device

Frequently asked questions
--------------------------

<a name="FAQ1"></a>
**(1) Can NetGuard completely protect my privacy?**

No - nothing can completely protect your privacy.
NetGuard will do its best, but it is limited by the fact it must use the VPN service.
This is the trade-off required to make a firewall which does not require root access.
Since the firewall must momentarily be turned off to update rules, and it only starts when Android "allows" it to start,
it will not offer 100% protection against an application connecting to the internet.
It will, however, be a lot better than nothing, especially if you are not rebooting often.

If you wanted to protect yourself more, you could (in theory at least) disable WiFi and mobile data before rebooting,
and only enable them on reboot, after the firewall service has started (and the small key icon is visible in the status bar).

Thanks @[pulser](https://github.com/pulser/)

<a name="FAQ2"></a>
**(2) Can I use VPN applications while using NetGuard?**

If the VPN application is using the [VPN service](http://developer.android.com/reference/android/net/VpnService.html),
then no, because NetGuard needs to use this service too and Android allows this to just one application at a time.

<a name="FAQ3"></a>
**(3) Can I use NetGuard on any Android version?**

No, because the method [addDisallowedApplication](http://developer.android.com/reference/android/net/VpnService.Builder.html#addDisallowedApplication(java.lang.String))
is being used the minimum required Android version is 5.0 (Lollipop).

<a name="FAQ4"></a>
**(4) Will NetGuard use extra battery power?**

No, unlike most of the similar closed source alternatives.


Support
-------

* Questions: please [use this forum](http://forum.xda-developers.com/showthread.php?t=3233012)
* Feature requests and bugs: please [report an issue](https://github.com/M66B/NetGuard/issues/new)

Please do not use GitHub for questions.

Contributing
------------

Translations:

* Translations to other languages are welcomed
* Check if the language [is supported by Android](http://stackoverflow.com/questions/7973023/what-is-the-list-of-supported-languages-locales-on-android) and find its locale
* Copy [this file](https://github.com/M66B/NetGuard/blob/master/app/src/main/res/values/strings.xml) to the correct locale folder
* Translate the strings in the copied file and omit all lines with **translatable="false"**
* Create a [pull request](https://help.github.com/articles/using-pull-requests) for the new/updated translation

Please note that you agree to the license below by contributing, including the copyright.


License
-------

[GNU General Public License version 3](http://www.gnu.org/licenses/gpl.txt)

Copyright (c) 2015 Marcel Bokhorst ([M66B](http://forum.xda-developers.com/member.php?u=2799345))

All rights reserved

This file is part of NetGuard.

NetGuard is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your discretion) any later version.

NetGuard is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with NetGuard. If not, see [http://www.gnu.org/licenses/](http://www.gnu.org/licenses/).
Initial commit 2015-10-24 17:59:20 +00:00			`# NetGuard`
Initial commit 2015-10-24 18:01:55 +00:00
Updated read me 2015-10-25 12:02:25 +00:00			`NetGuard is possibly the first free and open source no root firewall for Android.`

Added screenshot 2015-10-25 12:48:35 +00:00			`<img src="screenshot.png" width="232" height="371" hspace="4"/>`

Updated read me 2015-10-25 13:21:14 +00:00			`Features`
			`--------`

			`* No root required`
			`* Simple to use`
			`* Free and open source`
Simplify black hole service Solves threading issues, but needs testing 2015-10-25 15:16:20 +00:00			`* No extra battery usage`
Updated read me 2015-10-25 13:21:14 +00:00			`* No calling home`
Simplify black hole service Solves threading issues, but needs testing 2015-10-25 15:16:20 +00:00			`* No tracking (analytics)`
Updated read me 2015-10-25 13:21:14 +00:00			`* No ads`

Updated read me 2015-10-25 15:59:15 +00:00			`NetGuard doesn't even require internet permission.`

Added usage section 2015-10-25 13:06:16 +00:00			`Usage`
			`-----`

			`* Enable the firewall using the switch in the action bar`
			`* Allow/deny Wi-FI/mobile internet access using the icons at the right side of the application list`
Updated read me 2015-10-25 12:02:25 +00:00
Updated read me 2015-10-25 13:21:14 +00:00			`Permissions`
			`-----------`

			`* ACCESS_NETWORK_STATE: to check if the device is connected to the internet through Wi-Fi`
			`* RECEIVE_BOOT_COMPLETED: to start the firewall when starting the device`

Added FAQ 2015-10-25 12:13:52 +00:00			`Frequently asked questions`
			`--------------------------`

			`<a name="FAQ1"></a>`
Updated FAQ Thanks @pulser 2015-10-26 09:38:53 +00:00			`(1) Can NetGuard completely protect my privacy?`
Added FAQ 2015-10-25 12:13:52 +00:00
Updated FAQ Thanks @pulser 2015-10-26 09:38:53 +00:00			`No - nothing can completely protect your privacy.`
			`NetGuard will do its best, but it is limited by the fact it must use the VPN service.`
			`This is the trade-off required to make a firewall which does not require root access.`
			`Since the firewall must momentarily be turned off to update rules, and it only starts when Android "allows" it to start,`
			`it will not offer 100% protection against an application connecting to the internet.`
			`It will, however, be a lot better than nothing, especially if you are not rebooting often.`

			`If you wanted to protect yourself more, you could (in theory at least) disable WiFi and mobile data before rebooting,`
			`and only enable them on reboot, after the firewall service has started (and the small key icon is visible in the status bar).`

			`Thanks @[pulser](https://github.com/pulser/)`
Added FAQ 2015-10-25 12:13:52 +00:00
Updated FAQ 2015-10-25 13:25:42 +00:00			`<a name="FAQ2"></a>`
			`(2) Can I use VPN applications while using NetGuard?`

Updated FAQ 2015-10-25 13:49:56 +00:00			`If the VPN application is using the [VPN service](http://developer.android.com/reference/android/net/VpnService.html),`
Updated FAQ 2015-10-25 13:25:42 +00:00			`then no, because NetGuard needs to use this service too and Android allows this to just one application at a time.`
Added FAQ 2015-10-25 12:13:52 +00:00
Updated FAQ 2015-10-25 13:49:56 +00:00			`<a name="FAQ3"></a>`
			`(3) Can I use NetGuard on any Android version?`

			`No, because the method [addDisallowedApplication](http://developer.android.com/reference/android/net/VpnService.Builder.html#addDisallowedApplication(java.lang.String))`
			`is being used the minimum required Android version is 5.0 (Lollipop).`

Updated FAQ 2015-10-25 15:36:14 +00:00			`<a name="FAQ4"></a>`
			`(4) Will NetGuard use extra battery power?`

			`No, unlike most of the similar closed source alternatives.`


Added support section 2015-10-25 13:36:49 +00:00			`Support`
			`-------`

Added support menu 2015-10-25 15:48:41 +00:00			`* Questions: please [use this forum](http://forum.xda-developers.com/showthread.php?t=3233012)`
Added support section 2015-10-25 13:36:49 +00:00			`* Feature requests and bugs: please [report an issue](https://github.com/M66B/NetGuard/issues/new)`

			`Please do not use GitHub for questions.`

Updated read me 2015-10-25 12:02:25 +00:00			`Contributing`
			`------------`

Updated contributing section 2015-10-26 08:06:39 +00:00			`Translations:`

			`* Translations to other languages are welcomed`
			`* Check if the language [is supported by Android](http://stackoverflow.com/questions/7973023/what-is-the-list-of-supported-languages-locales-on-android) and find its locale`
			`* Copy [this file](https://github.com/M66B/NetGuard/blob/master/app/src/main/res/values/strings.xml) to the correct locale folder`
			`* Translate the strings in the copied file and omit all lines with translatable="false"`
			`* Create a [pull request](https://help.github.com/articles/using-pull-requests) for the new/updated translation`

Updated read me 2015-10-25 12:02:25 +00:00			`Please note that you agree to the license below by contributing, including the copyright.`


			`License`
			`-------`

			`[GNU General Public License version 3](http://www.gnu.org/licenses/gpl.txt)`

			`Copyright (c) 2015 Marcel Bokhorst ([M66B](http://forum.xda-developers.com/member.php?u=2799345))`

			`All rights reserved`

			`This file is part of NetGuard.`

			`NetGuard is free software: you can redistribute it and/or modify`
			`it under the terms of the GNU General Public License as published by`
			`the Free Software Foundation, either version 3 of the License, or`
			`(at your discretion) any later version.`

			`NetGuard is distributed in the hope that it will be useful,`
			`but WITHOUT ANY WARRANTY; without even the implied warranty of`
			`MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the`
			`GNU General Public License for more details.`

			`You should have received a copy of the GNU General Public License`
			`along with NetGuard. If not, see [http://www.gnu.org/licenses/](http://www.gnu.org/licenses/).`