1
0
Fork 0
mirror of https://github.com/M66B/NetGuard.git synced 2024-12-24 08:45:53 +00:00
NetGuard/README.md

104 lines
3.5 KiB
Markdown
Raw Normal View History

2015-10-24 17:59:20 +00:00
# NetGuard
2015-10-24 18:01:55 +00:00
2015-10-25 12:02:25 +00:00
NetGuard is possibly the first free and open source no root firewall for Android.
2015-10-25 12:48:35 +00:00
<img src="screenshot.png" width="232" height="371" hspace="4"/>
2015-10-25 13:21:14 +00:00
Features
--------
* No root required
* Simple to use
* Free and open source
* No extra battery usage
2015-10-25 13:21:14 +00:00
* No calling home
* No tracking (analytics)
2015-10-25 13:21:14 +00:00
* No ads
2015-10-25 15:59:15 +00:00
NetGuard doesn't even require internet permission.
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
2015-10-25 12:02:25 +00:00
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
2015-10-25 12:13:52 +00:00
Frequently asked questions
--------------------------
<a name="FAQ1"></a>
2015-10-25 13:25:42 +00:00
**(1) Can NetGuard protect my privacy?**
2015-10-25 12:13:52 +00:00
Not really, since the firewall cannot be started right after starting your device
2015-10-25 13:15:26 +00:00
and because updating firewall rules require momentarily turning off the firewall.
2015-10-25 12:13:52 +00:00
2015-10-25 13:25:42 +00:00
<a name="FAQ2"></a>
**(2) Can I use VPN applications while using NetGuard?**
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),
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.
2015-10-25 12:13:52 +00:00
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).
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.
2015-10-25 13:36:49 +00:00
Support
-------
2015-10-25 15:48:41 +00:00
* Questions: please [use this forum](http://forum.xda-developers.com/showthread.php?t=3233012)
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.
2015-10-25 12:02:25 +00:00
Contributing
------------
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
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/).