{"id":15148407,"url":"https://github.com/bunn/pistats","last_synced_at":"2025-12-24T20:33:02.892Z","repository":{"id":44163478,"uuid":"263673444","full_name":"Bunn/PiStats","owner":"Bunn","description":"macOS app to visualize Pi-hole information","archived":false,"fork":false,"pushed_at":"2024-08-27T21:38:13.000Z","size":4452,"stargazers_count":374,"open_issues_count":19,"forks_count":14,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-05T19:13:23.981Z","etag":null,"topics":["macos","pi-hole","swift","swiftui"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bunn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-13T15:43:49.000Z","updated_at":"2025-03-27T05:48:24.000Z","dependencies_parsed_at":"2024-01-02T21:56:06.388Z","dependency_job_id":"4e3e2344-f25b-47d0-b87b-089d565df6eb","html_url":"https://github.com/Bunn/PiStats","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bunn%2FPiStats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bunn%2FPiStats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bunn%2FPiStats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bunn%2FPiStats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bunn","download_url":"https://codeload.github.com/Bunn/PiStats/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247386265,"owners_count":20930619,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["macos","pi-hole","swift","swiftui"],"created_at":"2024-09-26T13:03:34.695Z","updated_at":"2025-12-24T20:33:02.887Z","avatar_url":"https://github.com/Bunn.png","language":"Swift","readme":"\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"130\" src=\"./images/icon.png\"\"\u003e\n\u003c/p\u003e\n\n\n# Pi Stats\n\nFollow up and manage the status of your [Pi-hole(s)](https://github.com/pi-hole/pi-hole) with this native iOS and macOS app.\n\nMonitor your Pi-hole instances right from your iPhone, iPad, or Mac menu bar. Pi Stats provides a beautiful, modern interface to keep track of your network-wide ad blocking statistics.\n\n**Supports Pi-hole 5.x and 6.x versions**\n\n## Features\n\n- Real-time monitoring of Pi-hole statistics\n-  Quick enable/disable controls for your Pi-hole\n-  Native iOS app with widgets support\n-  macOS menu bar app for quick access\n-  Secure credential storage in Keychain\n-  Beautiful charts and metrics\n-  Support for multiple Pi-hole instances\n\n## Pi Monitor\nFor optional monitoring of your Raspberry Pi, you can install [Pi Monitor](https://github.com/Bunn/pi_monitor). Once installed, enable it on Pi Stats for enhanced performance insights and real-time statistics.\n\n\n## Authentication Token\nIn order to use the \"enable/disable\" button you need to add your Authentication Token in the Settings screen.\n\n**For Pi-hole 5.x**, there are two different ways to get your authentication token:\n\n- /etc/pihole/setupVars.conf under WEBPASSWORD\n- WebUI -\u003e Settings -\u003e API -\u003e Show API Token\n\n**For Pi-hole 6.x**, use the same password you use to log into the web interface.\n\n\n## Troubleshooting\n\n### Can't Connect to Pi-hole (API Sessions Exceeded)\n\nIf you're unable to connect to your Pi-hole but other apps or websites can access it successfully, you may be encountering the `apiSeatsExceeded` error. This happens when the maximum number of concurrent API sessions has been reached.\n\n**How to fix:**\n\nYou can increase the API session limit by modifying the `webserver.api.max_sessions` setting:\n\n1. **Via configuration file**: Edit `/etc/pihole/pihole.toml` on your Pi-hole server\n2. **Via Web GUI**: Navigate to Settings → Expert Settings (All Settings) and search for `webserver.api.max_sessions` on Webserver and API\n\n**About this setting:**\n\n`webserver.api.max_sessions` controls the number of concurrent sessions allowed for the API. If the number of sessions exceeds this value, no new sessions will be allowed until existing sessions expire or are logged out. Note that this setting is only relevant when authentication is enabled.\n\n\n## Screenshots\n\n### iOS\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./images/screenshot-ios-1.png\" width=\"250\"\u003e\n  \u003cimg src=\"./images/screenshot-ios-2.png\" width=\"250\"\u003e\n  \u003cimg src=\"./images/screenshot-ios-3.png\" width=\"250\"\u003e\n\u003c/p\u003e\n\n### macOS\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./images/screenshot-mac-1.png\" width=\"400\"\u003e\n\u003c/p\u003e\n\n\n## Requirements\n\n- **iOS**: iOS 26.0 or later (iPhone, iPad)\n- **macOS**: macOS Sequoia (15.2) or later\n\nTested with Pi-hole 5.x and 6.x versions\n\n## Download\n\nPi Stats (and [SwiftHole](https://github.com/Bunn/SwiftHole)) is a free and open source hobby project of mine. If you want to support its development, you can download the apps using the options below:\n\n### macOS\n- **[Mac App Store](https://apps.apple.com/us/app/pi-stats/id1514075262?ls=1)** - Recommended for automatic updates\n- **[Gumroad](https://gum.co/iqhwv)** - Pay what you want (direct download)\n\n### iOS\n- **[iOS App Store](https://apps.apple.com/us/app/id1523024268)** - Available for iPhone and iPad\n\n\u003cp align=\"left\"\u003e\n  \u003cimg width=\"130\" src=\"./images/macstadium.png\"\"\u003e\n\u003c/p\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbunn%2Fpistats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbunn%2Fpistats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbunn%2Fpistats/lists"}