Skip to content

AdAway/AdAway

Repository files navigation

AdAway logo AdAway

Build Status Sonarcloud Status GitHub Downloads GitHub Sponsors License: GPL v3

AdAway is an open source ad blocker for Android using the hosts file and local vpn.

Home screen Preferences screen Root based ad blocker screen Backup and restore screen Help screen

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 and AdAway official website. 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.

Get it on official AdAway website Get it on XDA forum

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.

Get it on official AdAway website Get it on F-Droid

For devices older than Android 8 Oreo, use the version 4 of AdAway.

Get Host File Sources

See the Wiki, in particular the page 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 here or obtain more detailed community support via the XDA developer thread.

Contributing

You want to be involved in the project? Welcome onboard!
Check the contributing guide to learn how to report bugs, suggest features and make you first code contribution 👍

If you are looking for translating the application in your language, the translating guide is for you.

Project Status

AdAway is actively developed by:

We do not forget the past maintainers:

And we thank a lot to the original author:

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)
  • 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.