How slawek19926/vitals works
Vitals is a native macOS system-monitoring application. The principal workflow is: a user opens the app or menu-bar panel; the app samples system, process, disk, sensor, and power data; controllers transform snapshots into dashboards, tables, graphs, alerts, and benchmark results. The sampled code confirms the monitoring core, privileged XPC helper, process and disk views, settings, menu-bar presentation, and benchmark execution. Several README-listed pages are represented from the exact tree, though their internal wiring was not sampled.
Components 23
App Shell
- App Delegate
Sources/App/AppDelegate.swift - Main Window
Sources/App/Controllers/MainWindowController.swift - Menu Bar Modules
Sources/App/StatusItemController.swift - Floating Widgets
Sources/App/Widgets/FloatingWidgets.swift - Settings View
Sources/App/Controllers/SettingsViewController.swift
Monitoring Core
- Snapshot Monitor
Sources/App/Monitor.swift - System Sampler
Sources/SysCore/SysInfo.cpp - Fast File Scanner
Sources/App/FastScanner.swift
Runtime Views
- Summary Dashboard
Sources/App/Controllers/SummaryViewController.swift - Performance View
Sources/App/Controllers/PerformanceViewController.swift - Process View
Sources/App/Controllers/ProcessesViewController.swift - Power Sensors
Sources/App/Controllers/PowerFreqViewController.swift - Disk Space View
Sources/App/Controllers/DiskSpaceViewController.swift
Diagnostics
- Benchmark Runner
Sources/App/Controllers/BenchmarksViewController.swift - Health Checks
Sources/App/Controllers/HealthViewController.swift - Alert Engine
Sources/App/Alerts.swift - Media Engine
Sources/App/MediaEngine.swift
Privileged Access
- Helper Client
Sources/App/HelperClient.swift - Privileged Helper
Sources/Helper/main.swift
Other components
- User
- macOS APIs
- powermetrics
- launchd
Connections 28
- User → App Delegate: opens app
- App Delegate → Main Window: creates window
- Main Window → Summary Dashboard: opens page
- Main Window → Performance View: opens page
- Main Window → Process View: opens page
- Main Window → Power Sensors: opens page
- Main Window → Disk Space View: opens page
- Snapshot Monitor → System Sampler: samples data
- System Sampler → macOS APIs: reads metrics
- Snapshot Monitor → Summary Dashboard: publishes snapshots
- Snapshot Monitor → Performance View: publishes snapshots
- Snapshot Monitor → Process View: publishes snapshots
- Snapshot Monitor → Power Sensors: publishes snapshots
- Snapshot Monitor → Menu Bar Modules: publishes snapshots
- Snapshot Monitor → Floating Widgets: publishes snapshots
- Disk Space View → Fast File Scanner: scans files
- Fast File Scanner → macOS APIs: reads filesystem
- User → Menu Bar Modules: opens panel
- User → Settings View: changes preferences
- Settings View → Menu Bar Modules: configures modules
- Benchmark Runner → macOS APIs: runs tests
- Health Checks → macOS APIs: checks system
- Alert Engine → macOS APIs: sends notifications
- Performance View → Media Engine: shows codecs
- Helper Client → Privileged Helper: calls XPC
- Privileged Helper → System Sampler: samples privileged data
- Privileged Helper → powermetrics: reads power
- Privileged Helper → launchd: controls services