How exelban/stats works
Stats is a macOS menu-bar system monitor. Users enable monitoring modules, view live system metrics in menu-bar widgets and popups, and can optionally stream metrics through Remote. The repository separates the app shell and preferences from per-domain monitors, shared system/data services, and reusable visualizations. The README documents monitoring domains, remote-agent behavior, desktop widgets, and update checks; several module internals were not sampled, so uncertain runtime links are omitted or marked unverified.
Main entry points: Widgets Chart widgets · SystemKit.swift System access · CPU/main.swift CPU monitor · GPU/main.swift GPU monitor
Components 21
System monitors
- CPU monitor
Modules/CPU/main.swift - GPU monitor
Modules/GPU/main.swift - Memory monitor
Modules/RAM/main.swift - Disk monitor
Modules/Disk/main.swift - Network monitor
Modules/Net/main.swift - Battery monitor
Modules/Battery/main.swift - Bluetooth monitor
Modules/Bluetooth/main.swift - Clock monitor
Modules/Clock/main.swift - Sensors monitor
Modules/Sensors/main.swift - Remote agent
Modules/Remote/main.swift
Shared services
- SMC helper
SMC/main.swift - System access
Kit/plugins/SystemKit.swift - Preferences store
Kit/plugins/Store.swift - Remote service
Kit/plugins/SystemStats.swift - Update checks
Kit/plugins/Updater.swift
Display surfaces
- Chart widgets
Kit/Widgets - Chart configuration
Kit/plugins/Charts.swift - Desktop widget
Widgets/UnitedWidget.swift
Other components
- Mac user
Connections 20
- Mac user → Stats app: uses
- Mac user → Settings: configures
- Settings → Preferences store: persists settings
Stats/Views/Settings.swift - CPU monitor → System access: reads system data
Modules/CPU/main.swift - GPU monitor → System access: reads system data
- Memory monitor → System access: reads system data
- Disk monitor → System access: reads system data
- Network monitor → System access: reads system data
- Sensors monitor → SMC helper: reads sensor data
- Remote agent → Remote service: streams metrics
Modules/Remote/main.swift - Remote service → Mac user: reports remotely
- Update checks → Mac user: checks updates
- CPU monitor → Chart widgets: renders metrics
Modules/CPU/main.swift - GPU monitor → Chart widgets: renders metrics
Modules/GPU/main.swift - Memory monitor → Chart widgets: renders metrics
Modules/RAM/main.swift - Disk monitor → Chart widgets: renders metrics
Modules/Disk/main.swift - Network monitor → Chart widgets: renders metrics
Modules/Net/main.swift - Battery monitor → Chart widgets: renders metrics
Modules/Battery/main.swift - Chart configuration → Chart widgets: configures charts
Kit/plugins/Charts.swift - Desktop widget → Mac user: displays metrics