Quotio is a macOS application for managing AI provider accounts and tracking quota usage. It follows a Clean Architecture with four layers: Domain (core models), Application (business logic), Infrastructure (platform services), and Presentation (SwiftUI UI). The app provides both Local Proxy Mode (running a local proxy server CLIProxyAPI) and Monitor Mode (quota-only tracking) for AI services like Claude, OpenAI Codex, GitHub Copilot, Antigravity, and others. Key features include OAuth authentication flows, secure credential storage (Keychain/YubiKey), menu bar integration, automatic updates via Sparkle, telemetry via PostHog, AI CLI tool configuration, and Cloudflare tunnel management. The application uses modern Swift concurrency, protocol-oriented programming, and actor-based state management.
MonitorControl is a macOS menu-bar utility that controls external displays' brightness, contrast, and volume. It does not just send one kind of command; it uses multiple control paths: hardware DDC/CI over IOKit I2C on Intel Macs, DDC/CI over IOAVService on Apple Silicon, Apple's private DisplayServices API for Apple/Thunderbolt displays, gamma-ramp adjustments for software dimming, and transparent shade windows for virtual displays. User input flows from native media keys, custom keyboard shortcuts, and menu-bar sliders into a DisplayManager singleton, which coordinates native OSD overlays, smooth brightness transitions, and cross-display synchronization. The app uses Sparkle for updates, SimplyCoreAudio for audio device handling, MediaKeyTap for media-key interception, and KeyboardShortcuts for user-defined bindings. Architecturally, this is a classic Cocoa application with a storyboard-based preferences UI, a login helper app (MonitorControlHelper), and a clean separation between models (Display, AppleDisplay, OtherDisplay), support services (DisplayManager, DDC backends, OSD utilities, media-key handling), and view controllers for preferences and onboarding. Entry points are main.swift, AppDelegate, DisplayManager, and MenuHandler. Persistence is UserDefaults backed through a PrefKey enum, and the UI is localized into 19 languages. There is no data/research component; this is purely an end-user utility. The codebase is modular and well organized, with the DDC communication isolated into Intel and ARM backends and display-specific logic abstracted behind a base Display class. It is actively maintained, with recent commits and a modern dependency setup. Technical drift is medium rather than low because much of the functionality depends on private or undocumented macOS APIs (DisplayServices, CoreDisplay, OSDUIHelper) and the code contains many macOS-version-specific workarounds, but the project tracks current macOS releases and continues to update its fallbacks.
Remindian is a macOS menu bar application that synchronizes tasks between Obsidian (as the source of truth) and various task management systems including Apple Reminders, Things 3, Todoist, TickTick, Asana, Linear, and Calendar Feed. The app allows users to configure multiple sync profiles, each connecting a source (Obsidian Vault, TaskNotes, or Generic Markdown) to a destination task service. It runs in the background with manual or scheduled synchronization, provides UI for configuration and monitoring, and includes safety features like automatic backups before file modifications, audit logging, and conflict resolution where Obsidian always wins as the source of truth. The architecture follows a layered pattern with SwiftUI for the presentation layer, a service layer for platform-specific integrations, a model layer for data structures, and protocol-based abstractions (TaskSource/TaskDestination) that enable pluggable implementations. The SyncManager acts as the central coordinator, while the SyncEngine orchestrates the synchronization process. Key features include bidirectional sync with configurable directions, duplicate detection, natural language task entry, and extensive customization options for field mapping and filtering. The application demonstrates strong engineering practices with a comprehensive test suite, careful attention to data integrity through surgical file edits and backup systems, and thoughtful handling of platform-specific integrations. While deeply integrated with macOS and specific task services, it maintains clean separation of concerns through its protocol-oriented design, making core components potentially reusable in other synchronization contexts.
LosslessSwitcher is a macOS menu bar application that automatically adjusts the audio output device's sample rate and bit depth to match the lossless track currently playing in Apple Music. It works by reading system logs (OSLog) from Music.app and CoreAudio subsystems to detect the current track's sample rate, then uses CoreAudio APIs via the SimplyCoreAudio library to switch the output device's format. The app is not sandboxed because it requires access to system logs and the ability to modify audio device properties. It is built with SwiftUI and uses Combine for event-driven updates. The architecture includes a SwiftUI app entry point (QualityApp.swift), a legacy NSApplicationDelegate for menu bar management and permissions checking, an Observable class (MenuBarController) that owns the OutputDevices and MediaRemoteController, and parser utilities for extracting sample rate and bit depth from console entries. A user can also configure a custom script to run when the sample rate changes. The code demonstrates modern Swift patterns but is tightly coupled to macOS-specific frameworks and the Apple Music ecosystem.
AlDente is a macOS menu bar application designed to extend MacBook battery lifespan by limiting the maximum charging percentage. The application consists of two main components: a user-facing interface that runs with standard user privileges, and a privileged helper tool that communicates with the System Management Controller (SMC) to enforce battery charge limits. When the user sets a charge limit (e.g., 80%), the helper tool writes to the BCLM SMC key to prevent charging beyond that percentage. The app also monitors battery state and can prevent system sleep to maintain the charge limit when AC power is connected. The architecture cleanly separates concerns between the privileged operations (handled by the helper tool) and the user interface. Communication between components occurs via NSXPCConnection with a well-defined protocol (HelperToolProtocol). The application demonstrates solid macOS development practices including proper use of delegates for status updates, efficient polling for battery state, and clean separation of UI logic from business logic. While the repository contains legacy code from an older open-source version (as noted in the README), it includes a particularly valuable reusable component in SMC.swift. This file provides a robust, well-encapsulated interface for accessing the SMC on Intel-based Macs, handling all the low-level IOKit interactions, data type conversions, and error handling. The SMC implementation correctly manages the SMCParamStruct structure, supports various data types (UInt8, UInt32, FPE2, SP78), and includes extensions for reading temperature, fan speeds, and other sensor data.