TLDR
If you’re running Pi-hole on your network for ad blocking and privacy, you’ve probably wished you could toggle it on
and off without digging through a browser tab. The Pi-hole Controller Stream Deck plugin puts that control, and a lot
more, right on your physical deck.
See more here: Pi-hole Controller on Elgato Marketplace.
What It Does
Pi-hole Controller is a Stream Deck plugin with seven actions:
- Enable Blocking – re-enable Pi-hole with a single button press
- Disable Blocking – pause blocking instantly
- Disable for X – pause blocking for a configurable duration (30 seconds, 1 minute, 5 minutes, or custom), with a live
countdown shown directly on the button - Pi-hole Stats – display any of 11 metrics on a button: total queries, blocked queries, percent blocked, domains on
block lists, queries per minute, CPU load, memory usage, client count, and more - Pi-hole Status – a green/red indicator showing whether blocking is active, with an optional secondary metric
- Pi-hole Version – shows your installed version and highlights when an update is available
- Open Pi-hole UI – launches the admin interface in your browser with one press
Pi-hole v6 Support
Pi-hole v6 introduced a new app password authentication model, replacing the old static API key. This plugin is built
specifically for that – it handles session-based auth automatically, reuses sessions across restarts to avoid creating
unnecessary sessions on your Pi-hole, and cleanly re-authenticates if a session expires.
To get started, generate an app password in Pi-hole under Settings → Web Interface/API → Expert mode → App Password,
then enter it once in the plugin’s configuration panel. All buttons share the same connection settings.
Setup
1. Install the plugin from the
https://marketplace.elgato.com/product/pi-hole-controller-adc5d34c-67c8-4838-abb4-2489c225ce15
2. Drag any Pi-hole action onto your deck
3. In the configuration panel, enter your Pi-hole’s IP address and app password
4. Click Test Connection to verify, and you’re done
Notes
The plugin is built with the official Elgato TypeScript SDK and uses a shared polling architecture – all stat and
status buttons update from a single poll cycle, so there’s no unnecessary load on your Pi-hole regardless of how many
buttons you add.
