An open-source system monitoring status bar app for macOS users.
- Real-time upload/download speeds
- Green color indicator for speeds > 1 MB/s
- Public and local IP addresses
- Per-process network activity (top 5)
- Speed history graph
- CPU usage breakdown (User/System/Idle)
- CPU temperature indicator
- GPU usage and memory (Apple Silicon & discrete GPUs)
- Memory and swap usage
- Load average with history graph
- Top processes by CPU usage
- Top processes by memory usage
- System uptime
- Local disk usage with visual bars
- Read/write speed shown on the menu bar icon and in the dropdown, for the internal disk only — an attached external drive's I/O never makes the internal disk look busy
- Each attached external physical disk shows its own independent read/write speed in the dropdown; mounted disk images (e.g. Simulator runtimes) are excluded entirely
- Network disk detection
- Eject button for external and network disks
- Per-process disk I/O activity
Each monitor's menu bar icon can be shown/hidden independently, with per-monitor customization available from the Settings window (⌘,):
- General: Launch at login, show/hide each monitor's menu bar icon
- Network: Show/hide upload or download speed, speed unit (Auto/B/KB/MB per second), number of processes shown in the dropdown
- CPU: CPU/memory warning thresholds, which dropdown sections are shown (temperature, GPU, memory, load average, uptime), number of CPU/memory processes shown
- Disk: Disk usage warning threshold, show/hide network disks and process activity in the dropdown, number of processes shown
If every monitor is hidden, a small rescue icon appears in the menu bar so Settings stays reachable.
- Structured Logging: Uses Apple's
os_logfor debugging via Console.app (filter by "com.macstatusbar") - App Nap Prevention: Opts the whole process out of App Nap so background monitoring timers keep firing at their configured interval instead of being throttled while the app has no visible window
- Process Timeout: External commands (system_profiler, ioreg, ps, nettop) have configurable timeouts to prevent hangs
- Deadlock-Safe Subprocess Execution: Drains stdout/stderr concurrently while a subprocess runs, avoiding the classic
Process/Pipedeadlock that can occur once command output exceeds the OS pipe buffer - Network Resilience: WAN IP fetching includes retry with exponential backoff (1s, 2s, 4s) and fallback services (ipify.org -> ipinfo.io -> icanhazip.com)
- Network Reachability: NWPathMonitor detects connectivity changes to avoid unnecessary requests when offline
- Health Monitoring: Auto-recovery when monitors become stale (restarts after 30s of no updates)
- Rate Limiting: Prevents excessive updates under high system load (min 0.5s between updates)
- Data Validation: Clamps percentages (0-100%), speeds (max 10 Gbps), and handles counter wraparound
- Graceful Timer Cleanup: Proper deinit handling prevents race conditions on app termination
- macOS 14.0 (Sonoma) or later
- Apple Silicon (M1/M2/M3) recommended
- Xcode 15.0 or later (for building)
Note: Intel Mac support is not fully verified. If you encounter issues on Intel-based Macs, please open an issue or submit a pull request.
-
Clone the repository:
git clone https://github.com/ysyyork/MacStatusBar.git
-
Open
MacStatusBar.xcodeprojin Xcode -
Build and run (⌘R)
- Open
MacStatusBar.xcodeproj - Press
⌘Uor go to Product → Test
xcodebuild test -scheme MacStatusBar -destination 'platform=macOS'The app follows the MVVM (Model-View-ViewModel) pattern:
Sources/
├── App/
│ └── MacStatusBarApp.swift
├── Models/
│ └── AppSettings.swift
├── ViewModels/
│ ├── CPUMonitor.swift
│ ├── DiskMonitor.swift
│ └── NetworkMonitor.swift
├── Views/
│ ├── CPUContentView.swift
│ ├── DiskContentView.swift
│ ├── NetworkContentView.swift
│ ├── SettingsView.swift
│ └── SharedViews.swift
└── Utilities/
├── Formatters.swift
├── Logger.swift
└── ProcessRunner.swift
MIT License - see LICENSE for details.
Contributions are welcome! Feel free to submit issues and pull requests.