========

Adhell3
========

------------
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
------------

* ELM key (instructions below)

* Samsung device with Knox
* APK Editor Pro (download links in MediaFire folder) or another method of
renaming the apk's package ID.

------------
Installation
------------

Obtaining an ELM license key:

1. Enroll as a developer with this link: https://seap.samsung.com/enrollment

- If you already have an account, log in.
2. Open 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 "Generate License Key".
6. Accept agreement if one pops up.
7. Copy the ELM key. It should be 128 characters long.

Installing the app:

1. Download newest version of Adhell3 from the MediaFire folder. The latest
version is the only left in the root directory. Older versions are moved to the
"Older builds" folder.
2. Download and install APK Editor Pro.
- A 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 "Full Edit \(RESOURCE RE-BUI...\)".
6. Select the "Manifest" tab on the bottom.
7. Select the 2nd line:
 <manifest xmlns:android="http://schemas....

8. Rename the package name in the package field.

- Try to keep the name as unique as possible. Once a package name is associated
with too many different keys, it becomes blocked and Knox activation fails.
- This method does **not** require you to keep the package name the same length as
the original name.
- If you use same name each time, you'll able to just install updates over your
existing AdHell 3.
9. Press Save.
10. Press "Build" in the top right hand corner.
11. Press "Install".

Activating Adhell3:

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.
- The ELM keys should be 128 characters long
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.
--------------------------
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 or device with Android 8.1 or higher.
A: Use Full Edit or XML File Edit instead of Common Edit.

-------
Credits
-------
AdHell 3 an extension of AdHell, and AdHell 2. Changes were made by developer
fusionjack at Gitlab along with other contributors.