A unified macOS system monitoring application with elegant desktop widgets, smart notch integration, and secure auto-updates
Download • Architecture • Design System • Contributing
Transform your Mac into a comprehensive system intelligence hub with real-time monitoring, elegant widgets, and seamless notch integration — all while maintaining <1% CPU usage and <50MB memory footprint.
Perfect for developers who need real-time system insights without compromising performance.
- Battery Intelligence: Health metrics, cycle count, time estimates, charging optimization
- CPU Performance: Real-time usage, core breakdown, thermal state monitoring
- Memory Analysis: Pressure detection, usage breakdown, swap monitoring
- Weather (Optional): Temperature and upcoming changes in the Weather tab, menu bar, Smart Notch, and desktop widget
- System Health: Intelligent insights with actionable recommendations
- Desktop Widget Styles: Multiple layout options from compact to comprehensive displays
- Smart Notch Integration: Seamless integration with macOS notch area
- Notch Glow Alerts: Animated glow around the notch on key battery events
- Menu Bar Integration: Battery percentage and optional temperature display
- Tabbed Interface: Overview, Battery, CPU, Memory, Weather with unified design system
- Adaptive Refresh Rates: 2s critical → 30s idle (up to 83% CPU reduction)
- Direct System Access: IOKit + mach APIs (no subprocess overhead)
- Universal Binary: Native Intel + Apple Silicon optimization
- Memory Efficient: Smart caching with minimal footprint
- Secure Auto-Updates: Sparkle 2.7.1 with code signature verification
- Sandboxed Architecture: Minimal entitlements, maximum security
- Privacy First: No analytics; system metrics are local; optional network requests for updates + weather
 Compact Mode Unified metrics display |
 Expanded Mode Detailed system status |
 Weather Peek Temperature + upcoming change |
 Weather (Expanded) Optional weather row |
 System Glance Compact horizontal layout |
 System Status Three-column detailed view |
 System Dashboard Comprehensive metrics display |
 Weather Peek System Glance temperature swap-in |
||
 Overview Tab System health at a glance |
 Battery Tab Detailed power metrics |
 CPU Tab Processor performance analysis |
 Memory Tab Memory usage and pressure |
 Weather Tab Temperature + upcoming changes |
 Settings Elegant controls and preferences |
- Download
Microverse-v{version}.dmg - Drag to
/Applications - First Launch: System Settings → Privacy & Security → "Open Anyway"
- Look for the alien 👽 icon in your menu bar
git clone https://github.com/ashwch/microverse.git
cd microverse
make install # Requires Xcode 16+ or Swift 6.0+Requirements: macOS 13.0+, Universal Binary support
Package.swift
├── Microverse (executable) - SwiftUI + App Logic
│ ├── depends: BatteryCore
│ ├── depends: SystemCore
│ ├── depends: Sparkle (auto-updates)
│ └── depends: DynamicNotchKit (notch integration)
├── BatteryCore (framework) - IOKit battery monitoring
└── SystemCore (framework) - mach CPU/memory monitoring
Menu Bar: Click 👽 icon → Overview/Battery/CPU/Memory/Weather tabs
Desktop Widgets: Settings → Desktop Widget (toggle + style)
Smart Notch: Settings → Smart Notch (Left / Split / Off)
Weather: Settings → Weather (manual location + surfaces + optional peeks/highlights)
Notch Glow Alerts: Settings → Notch Glow Alerts (toggle + test buttons)
Hardware → Core Frameworks → Services → ViewModels → UI Components
IOKit BatteryCore SystemMonitoringService SwiftUI Views
mach SystemCore BatteryViewModel Desktop Widgets
- CPU Usage: Target <1% average (verified with Activity Monitor)
- Memory Footprint: Target <50MB (measured in Memory tab)
- Battery Impact: Minimal drain optimization
- Adaptive Refresh: 83% CPU reduction when idle
Semantic Color System
- 🟢 Battery (Energy) → Green success palette
- 🔵 CPU (Computing) → Blue neutral palette
- 🟣 Memory (Storage) → Purple distinctive palette
- ⚪ System (Overall) → White accent system
Typography Hierarchy (SF Pro Rounded)
- 32pt Display → Hero numbers (CPU/Memory percentages)
- 24pt Large Title → Battery percentage, section headers
- 18pt Title → Memory format ("X.X / Y.Y GB")
- 14pt Body → Standard content, time remaining
- 12pt Caption → Status text, info labels
Layout System (4px Grid)
- Consistent spacing scale: 4, 8, 12, 16, 24, 32pt
- Golden ratio proportions for UI elements
- Mathematical precision in component sizing
# Development build & run
make run
# Release build & install
make install
# Clean build artifacts
make clean
# Interactive Xcode build
./build_local.sh# Run unit tests (when available)
swift test
# Performance testing
# Monitor with Activity Monitor during development- SwiftUI Best Practices: @MainActor isolation, async/await patterns
- Design System Compliance: All UI uses MicroverseDesign tokens
- Performance First: Profile all changes for CPU/memory impact
- Error Handling: Graceful degradation with safe defaults
- Documentation: Comprehensive inline documentation
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Follow our Code Style Guide
- Ensure all changes use the design system tokens
- Test performance impact (CPU <1%, Memory <50MB)
- Submit a pull request with detailed description
- Technical Architecture - System design and data flow
- Design System - UI components and guidelines
- Performance Guide - Optimization strategies
- Auto-Update System - Security and implementation
- API Reference - Framework interfaces
- Sandboxed Application: Minimal entitlements for maximum security
- Secure Updates: Sparkle framework with signed appcast verification
- Privacy First: No analytics; system metrics are local; optional network requests for updates + weather
- Minimal Permissions: Network client for updates/weather + local system APIs for monitoring
| Metric | Target | Actual |
|---|---|---|
| CPU Usage (Active) | <1% | ~0.3% |
| CPU Usage (Idle) | <0.1% | ~0.05% |
| Memory Footprint | <50MB | ~35MB |
| Battery Impact | Minimal | Negligible |
| Launch Time | <2s | ~1.2s |
- Sparkle Framework - Secure automatic software updates
- DynamicNotchKit - Elegant notch integration for macOS
- Swift Concurrency - Modern async/await patterns for responsive UI
- SwiftUI Framework - Declarative UI with reactive state management
- IOKit & mach APIs - Direct system access for optimal performance
MIT License - Free and open source forever ✨
Copyright (c) 2024 Ashwini Chaudhary
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
[Full MIT License text...]
Ashwini Chaudhary (@ashwch)
Project Creator & Maintainer
Engineering Contributors
- @napender - Bug fixes and stability improvements
If Microverse enhances your development workflow, please star the repository to show your support and help others discover this project!
Built with ❤️ for the macOS development community
Perfect for developers who demand both elegance and performance in their system monitoring tools.