Disclaimer

Adhell3 is merely an app that is using the Samsung Knox SDK APIs.
In order to use these APIs, the Knox SDK and an ELM Development license key are needed.
These are Samsung's properties which are not available in this repository and therefore they need to be downloaded and obtained by the developer after accepting the agreement given by Samsung.
The developer is then responsible how this app will be used and I don't take any responsibilities of any damages caused by this app.

The Knox SDK can be downloaded here: https://seap.samsung.com/sdk/knox-android
The ELM License key can be obtained here: https://seap.samsung.com/license-keys/generate/edu
The API can be found here: https://seap.samsung.com/api-references/android/reference/packages.html

Official Discord: https://discord.gg/hfreZum

Adhell3 is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.
You should have received a copy of the license along with this work. If not, see http://creativecommons.org/licenses/by-nc/4.0/.

Background

The original Adhell was developed by Samsung's developer. After he was forced to remove the code from internet by Samsung, FiendFyre was stepped up by providing the Adhell2. But after a while, it is also discontinued.
Adhell3 is an extension of previous discontinued Adhell2 app with more additional features.

Features

• Mobile and Wi-Fi access disabler
  Disable internet access when on mobile or/and Wi-Fi for specific apps. This can be useful to avoid watching video accidentally by using mobile data.

• Custom deny firewall rule
  This can be used for example to define a custom firewall rule to block ads for Chrome app on port 53 for all ip addresses:
  com.android.chrome|*|53

• Whitelist URL for a specific app
  When you have a domain that you want to block system wide, but you need this domain on a particular app. Otherwise, the app won't work.
  Instead whitelist-ing this app, you can just whitelist that domain for this app.
  Example: Block the domain graph.facebook.com system wide, but allows it for Facebook Messenger so that it can be used for login:
  com.facebook.orca|graph.facebook.com

• Support local host source
  The host file can be located on internal or external storage.
  An example to use host.txt file which is located at internal storage:
  file:///mnt/sdcard/hosts.txt

• Show the content of host source
  Show the list of domains of individual host source or the list of all blocked domains from all host sources.
  This can be useful to check whether particular domain is in the list.
  The list contains of unique domains.

• Backup and restore database
  Backup the content of the database on internal storage so that later it can be used to restore the database if the database is somehow damage.

• DNS per application basis
  Set custom DNS for selected apps. Only user apps are supported.

Building APK

• Download the script from https://gitlab.com/fusionjack/adhell3-scripts
• Follow the instruction in the README

Customization

Change the default 15k domain limit

• Put domain.limit in app.properties, e.g. domain.limit=50000

Make license key available when activating Adhell3

• Put skl.key in app.properties, e.g. skl.key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
• If you use these properties, beware when you distribute your app as the app contains the keys in plain text
• This is just for convenience purpose so that you don't need to make your keys somewhere available when you are on the phone, hence this only works on a new installation

Domain prefix

• Prefix all domains (with the exception of Filter Lists) with * or nothing.
• Valid domain.prefix options: domain.prefix=true, domain.prefix=false
• If you choose not to define a prefixing option, domains will not be prefixed.
• Put domain.prefix in app.properties
• domain.prefix=true -> prefix all domains with *
• domain.prefix=false -> don't prefix anything, keep domains as they are
• nothing -> no prefix

Hidden features

• Beware that enabling some hidden features may cause the device to malfunction if they are not used with precaution, especially when disabling system apps. Enable them at your own risk.
• Add enable.disableApps=true in app.properties -> to enable 'Disable Apps' feature:
  An ability to disable user or system applications entirely
• Add enable.appComponent=true in app.properties -> to enable 'App Component' feature:
  An ability to disable app's permissions, services and receivers. Only user apps are supported.
• Add appComponent.showSytemApps=true in app.properties -> to list system apps in 'App Component'

Override default host with your own compiled host

• Put default.host in app.properties, e.g. default.host=https://gitlab.com/fusionjack/hosts/raw/master/hosts

Prerequisite for using Adhell3

You need an ELM Development license key in order to use Adhell3.
You need to enroll as a developer in order to get this license. As for developer, the license needs to be renewed every 3 months.
When you receive a mail about license expiration, you usually cannot generate a new key immediately and you need to wait for some days.
During this time, Adhell3 is still working properly. Adhell3 will show an activation dialog if the key cannot be used anymore. This time you should be able to generate a new key.

• Enroll as a developer with this link: https://seap.samsung.com/enrollment
• Generate a license key with this link: https://seap.samsung.com/license-keys/generate/edu
• Give an alias name, e.g. test
• Click on Generate License Key

Credits

• Adhell3 is based on FiendFyre's Adhell2 which is heavily modified by me.
  
• Big thanks to @mmotti who provides a host file for Adhell3. You can visit his Github here: https://github.com/mmotti/mmotti-host-file
• Adhell3 is using icons from https://material.io/icons