diff --git a/README.md b/README.md new file mode 100644 index 0000000..152e940 --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# Private DNS Quick Toggle +A quick settings tile to switch your private dns provider. Supports any number of providers. Makes it easy to turn adblocking dns servers on or off with just +a single tap. + +![Private DNS app screenshot](readme.png) + +## Installation +Get the latest apk on the [releases page](https://github.com/karasevm/PrivateDNSAndroid/releases/latest). + +For the app to work properly you'll need to provide it permissions via ADB: + +1. Get to your PC and download platform tools from google [here](https://developer.android.com/studio/releases/platform-tools). +2. Extract the tools, and open terminal in the same directory ([Windows guide](https://youtu.be/6vVFmOcIADg?t=38), [macos guide](https://www.howtogeek.com/210147/how-to-open-terminal-in-the-current-os-x-finder-location/)). +3. Turn on USB Debugging on your phone (This may require different steps, for Xiaomi you also have to enable `USB Debugging (Security settings)`, but generally [this video guide](https://youtu.be/Ucs34BkfPB0?t=29) should work on most phones) +4. Connect your phone to your PC +5. Run this command in the terminal + +``` +./adb shell pm grant ru.karasevm.privatednstoggle android.permission.WRITE_SECURE_SETTINGS +``` + +6. That's it, you should have the app installed. + diff --git a/readme.png b/readme.png new file mode 100644 index 0000000..4dee806 Binary files /dev/null and b/readme.png differ