Skip to content

numbermonkey/pihole-dashboard-inky

 
 

Repository files navigation

Clean Dashboard for Pi-Hole CHANGED TO INKY

Minimal and clean dashboard to visualize some stats of Pi-Hole with an E-Ink display attached to your Raspberry Pi.

This is very useful if you keep a Pi Zero with Pi-Hole connected to your router and you want a clean dashboard to monitor its status.

PyPI Updated Powered-By
Raspberry Pi Zero

My Setup

Configuration

The tool should run out of the box with standard installation of Pi-Hole. If you have a different setup probably the scripts should be adapted too. If your instance of Pi-Hole is running on a different port than 80, you should change it inside pihole_dashboard/__init__.py.

UPDATE BELOW FOR INKY PHAT

Inky e-Paper dependency

Making the E-Ink display work is not fully covered here, as it depends mostly on the display you use. As said before, I have the Inky Phat 2.13 inch E-Ink display, that has a nice Getting Started guide here: https://learn.pimoroni.com/tutorial/sandyj/getting-started-with-inky-phat.

You can find there the list of required dependencies for Python and how to run and test the provided examples.

#Remember that you need root access to control the display, so be sure to run the python example as root.

Installation

The installation requires to have already a Raspberry with Pi-Hole installed and correctly running, if you have problem installing Pi-Hole check their README.

From Source

git clone https://github.com/santoru/pihole-dashboard-inky
cd pihole-dashboard-inky
sudo pip3 install .

Once installed, reboot the Raspberry Pi. The dashboard should appear few minutes after the reboot.

Uninstall

You can remove the tool anytime by running

sudo pip uninstall pihole-dashboard-inky

How it works

I need to write uo the Cron bit. It was a bit weird on DietPi. But I basically call pihole-dashboard-inky-draw every 5 mins

Troubleshooting

If the dashboard is not displaying, you can check if the script return an error by running

sudo pihole-dashboard-inky-draw

If everything is working as expected, nothing will be printed out. If you still have errors, please open an issue.

About

Minimal and clean dashboard to visualize some stats of Pi-Hole with an E-Ink display attached to your Raspberry Pi

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 100.0%