========

AdHell 3
========

------------
Introduction
------------

AdHell 3 is an app that utilizes Samsung Knox SDK APIs, and previously Knox
Standard SDK APIs. To use Knox, the app requires a Knox license key (instructions
below).

----------
Disclaimer
----------

The developer and uploader of this app are not responsibile for any damages caused
by this app, or responsible for any Samsung terms that may be violated in the
process.

------------
Requirements
------------

For AdHell 3, v3.0.0 and v.3.1.1:

* ELM key (instructions below)
* Samsung device with Knox
* APK Editor Pro (download links below) or another method of renaming the apk's
package ID.

---------
Features
---------

Features of this app include, but are not limited to, the following:

* Domain blocking
* Mobile and Wi-Fi data access disabler
* Custom firewall denial rules
* Whitelist URL for specific apps
* App permissions (no system apps)
NOTE: v3.1.1 with Knox SDK can only disable dangerous level permissions.
* App services and receiver disabler
* DNS on per app basis

---------------
Getting Started
---------------

Obtaining an Enteprise license (ELM) key:

1. Enroll as a developer with this link: https://seap.samsung.com/enrollment
2. Generate a ELM key with this link: https://seap.samsung.com/license-
keys/generate/edu
3. Leave "key type" as "Development Key".
4. Give the key a name under "Add key alias".
5. Click on "Get License Key".
6. Accept agreement if one pops up.
7. Copy the ELM key. It should be 128 characters long.
Installing application (devices on Android 8.0 and below):
1. Download newest version of AdHell 3 from the MediaFire folder.
* Version numbers are in file name.
2. Download APK Editor Pro.
* Copy of this app is provided in the same MediaFire folder with the name
apkEditorPro-1.8.28.apk.
* Alternatively, you can download it directly from the dev's site:
http://www.apkeditorfree.com/
3. Open APK Editor Pro.
4. Choose "Select an APK File" and find the downloaded apk file.
5. Select "Common Edit".
6. Edit the "Package name" field and change it to a unique name.
7. It's best to stick to the same package ID length. 3.8.9 characters
8. If you use same name each time, you should be able to just install updates
over your existing AdHell 3.
9. Ensure "Rename the package name in resources.arsc" is checked.
10. Press Save.
11. Press "Install".

Installing application (devices on Android 8.1 and above):

1. Download newest version of AdHell 3 from the MediaFire folder.
* Version numbers are in file name.
2. Download APK Editor Pro.
* Copy of this app is provided in the same MediaFire folder with the name
apkEditorPro-1.8.28.apk.
* Alternatively, you can download it directly from the dev's site:
http://www.apkeditorfree.com/
3. Open APK Editor Pro.
4. Choose "Select an APK File" and find the downloaded apk file.
5. Select "XML File Edit"
6. Select the file "AndroidManifest.xml"
7. On line 6 (or around there), you'll find the package id: package="____".
- It's best to stick to the same package ID length. 3.8.9 characters.
Leave the quotes.
- If you use same name each time, you should be able to just install
updates over your existing AdHell 3.
8. Press Save icon (lower left).
9. Go back.
10. Press Save again.
11. Select "Install".

Activating AdHell 3:
1. Grant the app administrator privileges.
2. Enter your license key.
3. Activate.

---------------
Tips and Tricks
---------------

* If you use Chrome:

- add com.android.chrome|*|53 to your Blacklist as a firewall rule. This will
enable domain blocking to work in Chrome. You will need to toggle firewall rules
off then on for changes to take effect.
* If you're using the new versions of Samsung Internet that come with Android Pie
(version 9+):
- add com.sec.android.app.sbrowser|*|53 to your Blacklist as a firewall rule.
This will enable domain blocking to work in newest versions of Samsung Internet.
You will need to toggle firewall rules off then on for changes to take effect.
---------
Updating
---------

1. Download the updated apk from the MediaFire folder.

2. Change the APK's package ID using APK Editor Pro, and use the same ID as you
did previously.
3. Install it over your existing app.

---------------
Troubleshooting
---------------

If the app fails to activate, it's usually because of one or more of the three
following reasons:
1. You have the wrong type of key.
=> Ensure you have the right key.
- It should be a 128 character long key.
2. Your package ID was black listed.
=> Rename your APK again as unique of a name as possible
3. Your license key was suspended.
=> Generate a new key and use that.
It's recommended to look at all 3 possibilities before trying again.

If you get an 201 error, try closing and re-opening the app.

--------------------------
Frequently Asked Questions
--------------------------
Q: What is the difference between AdHell 3.0.0 and 3.1.1?
A: The difference is in the Knox SDK used for both. For the end user, it's
important to know that 3.0.0 is no longer supported and only the 3.1.1 will receive
new updates. On the other hand, due to the SDK used for 3.1.1, users can no longer
disable any permission for apps that they want. They can only disable 'dangerous'
level permissions.

Q: How frequently are new builds added?

A: I usually check the Gitlab multiple times a day, and try to upload new builds
as soon as they're available. If the new build contains significant changes, I may
wait until others and myself had a chance to test them first so that I don't upload
a build that contains major bugs.

Q: I get the error "There was a problem parsing the package" when trying to modify
the package ID, and I have Note 9.
A: Try installing the APK without changing the ID. Alternatively, use XML File Edit
instead of Common Edit.

Have more questions about how the app works, or encounter a general problem with
the app?
Join us on discord: https://discord.gg/KJTxgJ9

If you encounter what appears to be problem specific to a build I uploaded, please

make a post at: https://reddit.com/r/AdHell
-------
Credits
-------
AdHell 3 an extension of AdHell, and AdHell 2. Changes were made by developer
fusionjack at Gitlab along with other contributors.