Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AdAway/AdAway
AdAway is a free and open source ad blocker for Android.
https://github.com/AdAway/AdAway
ad-blocker android blocker hosts vpn
Last synced: about 1 month ago
JSON representation
AdAway is a free and open source ad blocker for Android.
- Host: GitHub
- URL: https://github.com/AdAway/AdAway
- Owner: AdAway
- License: gpl-3.0
- Created: 2012-07-15T15:34:47.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-10-27T15:07:44.000Z (about 2 months ago)
- Last Synced: 2024-10-27T15:23:06.686Z (about 2 months ago)
- Topics: ad-blocker, android, blocker, hosts, vpn
- Language: C
- Homepage: https://adaway.org
- Size: 38.9 MB
- Stars: 7,204
- Watchers: 232
- Forks: 576
- Open Issues: 579
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-starred - AdAway - AdAway is an open source ad blocker for Android using the hosts file. (C)
README
#  AdAway
[](https://github.com/AdAway/AdAway/actions/workflows/android-ci.yml)
[](https://sonarcloud.io/project/overview?id=org.adaway)
[](https://github.com/AdAway/AdAway/releases)
[](https://github.com/sponsors/PerfectSlayer)
[](/LICENSE.md)
AdAway is an open source ad blocker for Android using the hosts file and local vpn.
[
](metadata/en-US/phoneScreenshots/screenshot1.png)
[
](metadata/en-US/phoneScreenshots/screenshot2.png)
[
](metadata/en-US/phoneScreenshots/screenshot3.png)
[
](metadata/en-US/phoneScreenshots/screenshot4.png)
[
](metadata/en-US/phoneScreenshots/screenshot5.png)
For more information visit https://adaway.org
## Installing
There are two kinds of release:
* The preview builds: on the bleeding edge of development - for testers or adventurous
* The stable builds: ready for every day usage - for end users
### Preview builds
**Requirements:** Android 8 _Oreo_ or above
For users with bugs, there may be preview builds available from the [XDA development thread](https://forum.xda-developers.com/showthread.php?t=2190753) and [AdAway official website](https://app.adaway.org/beta.apk).
It is recommended to try those builds to see if your issue is resolved before creating an issue.
The preview builds may contain bug fixes or new features for new android versions.
[
](https://app.adaway.org/beta.apk)
[
](https://forum.xda-developers.com/showthread.php?t=2190753)
### Stable builds
**Requirements:**
* Android Android 8 _Oreo_ or above
After preview builds have been tested by the more technical or responsive community within the forums, we will then post the stable build to F-Droid.
[](https://app.adaway.org/adaway.apk)
[
](https://f-droid.org/app/org.adaway)
For devices older than Android 8 _Oreo_, use the version 4 of AdAway.
## Get Host File Sources
See the [Wiki](https://github.com/AdAway/AdAway/wiki), in particular the page [HostsSources](https://github.com/AdAway/AdAway/wiki/HostsSources) for an assorted list of sources you can use in AdAway.
Add the ones you like to the AdAway "Hosts sources" section.
## Getting Help
You can post [Issues](https://github.com/AdAway/AdAway/issues) here or obtain more detailed community support via the [XDA developer thread](http://forum.xda-developers.com/showthread.php?t=2190753).
## Contributing
You want to be involved in the project? Welcome onboard!
Check [the contributing guide](CONTRIBUTING.md) to learn how to report bugs, suggest features and make you first code contribution :+1:
If you are looking for translating the application in your language, [the translating guide](TRANSLATING.md) is for you.
## Project Status
AdAway is actively developed by:
* Bruce Bujon ([@PerfectSlayer](https://github.com/PerfectSlayer)) - Developer
[PayPal](https://paypal.me/BruceBUJON) | [GitHub Sponsorship](https://github.com/sponsors/PerfectSlayer)
* Daniel Mönch ([@Vankog](https://github.com/Vankog)) - Translations
* Jawz101 ([@jawz101](https://github.com/jawz101)) - Hosts list
* Anxhelo Lushka ([@AnXh3L0](https://github.com/AnXh3L0)) - Web site
We do not forget the past maintainers:
* Dāvis Mošenkovs ([@DavisNT](https://github.com/DavisNT)) - Developer
[Paypal](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=5GUHNXYE58RZS&lc=US&item_name=AdAway%20Donation&no_note=0&no_shipping=1)
* [@0-kaladin](https://github.com/0-kaladin) - Developer and XDA OP
* Sanjay Govind ([@sanjay900](https://github.com/sanjay900)) - Developer
And we thank a lot to the original author:
* Dominik Schürmann ([@dschuermann](https://github.com/dschuermann)) - Original developer
[Paypal](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=android%40schuermann.eu&lc=US&item_name=AdAway%20Donation&no_note=0&no_shipping=1¤cy_code=EUR) | [Flattr](https://flattr.com/thing/369138/AdAway-Ad-blocker-for-Android) | BTC: `173kZxbkKuvnF5fa5b7t21kqU5XfEvvwTs`
## Permissions
AdAway requires the following permissions:
* `INTERNET` to download hosts files and application updates. It can send bug reports and telemetry [if the user wants to (opt-in only)](https://github.com/AdAway/AdAway/wiki/Telemetry)
* `ACCESS_NETWORK_STATE` to restart VPN on network connection change
* `RECEIVE_BOOT_COMPLETED` to start the VPN on boot
* `FOREGROUND_SERVICE` to run the VPN service in foreground
* `POST_NOTIFICATIONS` to post notifications about hosts source update, application update and VPN controls. All notifications can be enabled or disabled independently.
* `REQUEST_INSTALL_PACKAGES` to update the application using the builtin updater
* `QUERY_ALL_PACKAGES` to let the user pick the applications to exclude from VPN
## Licenses
AdAway is licensed under the GPLv3+.
The file LICENSE includes the full license text.
For more details, check [the license notes](LICENSE.md).