A simple Xamarin Forms Shell app to manage your local Pi-hole instance.
The idea of this app is to provide "quick toggles" and display information that would be useful at a glance. My goal is not to reach parity with the (awesome) web app that already exists. Use cases include:
- Allow less technically inclined/interested people to disable your home's pi-hole temporarily.
- Ensure your pi-hole instance is up and running.
- Check that a given device is routing through pi-hole.
Feel free to open an issue for any ideas/concerns, after checking out the feature road map. Pull requests are welcomed and encouraged!
This app is available on the iOS app store under the name Pi ContrHOLE.
Download, Visual Studio 2019 (Mac/Windows), open the .sln file, and build for the appropriate device (ios/android).
Although this app is technically cross platform, I haven't been actively testing the Android version (and as such there might be some minor issues with it).
You will need an API key for anything in that requires authorization. For more details check here.
The Pi-Hole web UI's generated API key can be found here: Settings > API/Web Interface > Show API Token. The app also lets you scan the QR code that pi-hole generates.
One final place you can find the key is as the WEBPASSWORD found under /etc/pihole/setupVars.conf
The API utilized is outlined here.
Please feel free to push feature/bug PRs! I'll merge it into dev branch, which automatically builds and releases a TestFlight build via AppCenter. If you'd like to join the experimental Testflight channel, contact me!
Once we agree everything is working on iOS, i'll merge to master, and a new App Store version will be released.
This work is licensed under a Creative Commons Attribution 3.0 Unported License.
This work is licensed under the Creative Commons Attribution 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by/3.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.