Pi-hole with Inky pHAT ePaper display
This is my Pi-hole with an ePaper display. There are many like it, but this one is mine.
This script will trigger a periodic refresh of your Inky pHAT display to show some Pi-hole stats. You'll see your device's host name and IP (in case you haven't set a static IP address or need to manually adjust the DNS settings for some of your devices), the last time at which the display was refreshed, as well as some basic Pi-hole info:
- Status: connected or not
- How many clients are currently connected
- Queries in past 24 hours
- How many queries (count and percentage) have been blocked
Setup
-
Set up your Pi-hole, I followed adafruit's instructions here.
!! If you're working on a Windows machine, make sure you've set Unix style line endings when creating yourwpa_supplicant.confandsshfiles !! -
Set up your Inky pHAT, I followed Pimoroni's instructions here.
I found that after following the installation instructions, I was unable to run any of the included examples, nor was I able to run any of my own code due to a numpy dependency error. The solution was found on numpy's troubleshooting page, run:
sudo apt-get install libatlas-base-dev -
Clone this repo.
-
Edit your crontab file to set recurring screen refresh:
crontab -eadd this line:
*/15 6-24 * * * python <path to pihole_status_display.py>which will trigger the script every 15 minutes on the quarter hour between the hours of 6am and midnight.
How it works
- Get and format the update time - date and time at which the script was called.
- Pull some board info - the hostname and IP address of your pi.
- Pull some stats from your Pi-hole API in a struct (dict).
- If your Pi-hole is up and your pi is able to query the API within 5 seconds, return status = "Connected", as well as the number of connected clients, DNS queries made today, total ads blocked today, and percentage of queries blocked.
- If your pi is unable to query the API, return status = "DOWN", and set all the pihole_stats fields to "-----".
- Draw the results on the Inky pHAT screen.
- If the API was successfully queried, results will be shown in BLACK.
- If the script was unable to query the Pi-hole API, the results will be shown in RED:
5 Oct 6, 2022
59 Oct 24, 2022
2 Mar 15, 2022
32 Jul 2, 2022
249 Jan 2, 2023
104 Dec 14, 2022
64 Oct 11, 2022
1 Nov 28, 2021
5 Oct 31, 2022
40.3k Jan 9, 2023
5 Jan 15, 2022
254 Dec 29, 2022
1 Nov 27, 2021
16 Dec 28, 2022
1 Jun 1, 2022
7.3k Dec 31, 2022
64 Dec 28, 2022
622 Dec 18, 2022
32 Jul 2, 2022
104 Dec 14, 2022
64 Oct 11, 2022
1 Nov 27, 2021
2.5k Jan 5, 2023
4 Dec 19, 2022
1 May 1, 2022
13 Jan 2, 2023
3 Apr 8, 2022
2 Dec 30, 2021