# PiBar for macOS

PiBar gives you all the tools you need to manage your [Pi-hole](https://pi-hole.net)(s) right from your macOS menu bar.

## Features

- Supports both Pi-hole v5 and Pi-hole v6+
- Smart setup wizard that auto-detects your Pi-hole version, port, and SSL
- Display DNS query stats in your macOS menu bar
- Supports multiple Pi-holes (inc. quadruple failover setups!)
- Toggle your Pi-hole(s) on/off from the menu or anywhere via ⌘⌥⇧P
- Displays warnings if any or all of your Pi-holes are inaccessible or disabled
- Pi-hole v6 session auto-refresh with saved password support
- Credentials stored securely in macOS Keychain
- No capital "h" in the word "hole" in the app or in the code
- Beautiful app icon
- Totally FOSS

## Screenshots

![PiBar Screenshots](/.github/screenshots.jpg?raw=true)

## Download

### PiBar 1.2 (Pi-hole 5 and 6)

- Requires macOS 15 (Sequoia) or later
- [Download PiBar v1.2](https://s3.amazonaws.com/amiantos/PiBar-1.2.zip)
- Or, [Purchase PiBar on the App Store](https://apps.apple.com/us/app/pibar-for-pi-hole/id1514292645?ls=1) for automatic updates.
- Or, `brew install pibar` to install using Homebrew.

### PiBar 1.1.2 (Pi-hole 5 and older)

- Requires macOS 10.12 (Sierra) or later
- [Download PiBar v1.1.2](https://s3.amazonaws.com/amiantos/PiBar-1.1.2.zip)

## Quick Start

1. Launch PiBar
2. Click on the PiBar icon in your menu bar and go to Preferences
3. Click Add and enter your Pi-hole's hostname or IP address
4. PiBar will automatically detect your Pi-hole version and settings
5. Enter your password (v6) or API token (v5) if prompted
6. Add more Pi-holes if you have them :)
7. Adjust your menu bar display preferences
8. Close the Preferences window and enjoy!

## Like PiBar a lot?

- [Purchase PiBar on the App Store](https://apps.apple.com/us/app/pibar-for-pi-hole/id1514292645?ls=1)

## Get Help

- Feel free to [post an issue](https://github.com/amiantos/pibar/issues/new) if you need help or have a feature suggestion. Dream big!
- There's also [a Discourse forum over here](https://discuss.bradroot.me/tags/c/projects/13/pibar/5) to discuss and seek support.

## Credits

- PiBar was built by [Brad Root](https://github.com/amiantos)
- PiBar's wonderful icon was designed by [Jozef Banuelos](https://jozef.design)
- Pi-hole is a registered trademark of Pi-hole LLC.
- PiBar is an independent project and is not directly affiliated with Pi-hole LLC or the Pi-hole community.
