Skip to content

KeepCoolCH/UniFiStatusBarApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

19 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Screenshot

πŸ“‘ UniFi Status Bar App

Monitor your UniFi Network directly from the macOS menu bar β€”
view gateway health, connected devices, live throughput, PoE stats, and client information in real-time.
Developed by Kevin Tobler 🌐 www.kevintobler.ch


🧩 Overview

UniFiStatusBarApp is a lightweight macOS utility that connects to your local UniFi Network Controller and displays key system metrics right in the macOS menu bar.

Features include:

  • πŸ”Ή Automatic detection of your UniFi Controller (Gateway IP)
  • πŸ”Ή Live health status, device list, and client connections
  • πŸ”Ή Real-time throughput (Mbps) and PoE information
  • πŸ”Ή Compact menu bar UI for quick network insights
  • πŸ”Ή Local API access β€” no cloud login required

πŸ“Έ Screenshot

Screenshot


βš™οΈ Requirements

  • macOS 14.6 (Sonoma) or newer
  • UniFi Controller reachable in your local network (Network Version 9.4.19 or newer)
  • A valid UniFi API Key (Settings β†’ System β†’ API Access)

🧭 Installation

Download Prebuilt App

  • Unzip the App and run it or move it to the Applications folder

πŸ”‘ First Launch

When starting the app for the first time:

  1. The app automatically detects your local UniFi Gateway (e.g. 192.168.1.1)
  2. A small settings window appears asking for your API Key
  3. Paste your UniFi key and press πŸ’Ύ Save and Connect
  4. The app refreshes automatically and starts displaying live stats

🧱 Features

Category Description
🌐 Controller Shows online/offline status and UniFi subsystems
🧩 Devices Lists all UniFi devices (Gateway, Switches, APs)
πŸ“Š Clients Displays connected clients, signal strength, and uptime
⚑ PoE Stats Detects total PoE draw per device
πŸ”„ Auto-Refresh Updates data every 2 seconds
πŸ”’ Local Access Works entirely offline (via HTTPS API)

🎨 UI & Behavior

  • 🧭 Menu Bar Icon:
  • βš™οΈ Settings Button: Opens API key window
  • πŸ’Ύ Save and Connect: Stores your key securely
  • πŸ” Auto-Reload: When API key is saved, app reconnects automatically

🧩 Contact

πŸ“§ internet@kevintobler.ch
πŸ™ github.com/KeepCoolCH


About

UniFiStatusBarApp is a lightweight macOS utility that connects to your local **UniFi Network Controller** and displays key system metrics right in the macOS menu bar.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages