Stats is a native macOS menu bar system monitor that provides real-time hardware and software metrics for CPU, GPU, RAM, Disk, Network, Battery, Sensors (temperature/voltage/fan), Bluetooth, and Clock. Built entirely in Swift with AppKit, it uses private IOKit, SMC, and IOReport APIs to collect system data, and offers highly customizable widgets (mini, line/bar/pie charts, tachometer, text, etc.) drawn directly in the menu bar. The architecture is modular: each monitored subsystem lives in its own 'Module' directory with a consistent structure (main.swift, readers, popup, settings, notifications, portal). A shared 'Kit' framework provides reusable components including a reader base class with interval management and history persistence via bundled LevelDB, a thread-safe key-value store wrapper, and a set of custom drawing chart widgets. The app also supports remote monitoring via an optional cloud service (System Stats), privileged helper for fan control, macOS widget extensions, and extensive localization (40+ languages). The codebase demonstrates strong engineering practices with clean abstractions, encapsulation, and reusability, though some modules exhibit boilerplate duplication and the project relies on several deprecated or private APIs that may require updates for future macOS releases.
This repository is a comprehensive curated knowledge base and reference directory focused on time tracking, productivity methodologies, and related tools. The dominant character is a flat collection of over 3000 markdown files under `details/`, each describing a specific software tool, productivity technique, author, or research finding in a structured format (overview, features, pricing, use cases). While primarily a reference resource, the repo also contains a few functional software components, including a Spring Boot + Vaadin reporting app for Toggl (toggl-reporter), a Django monorepo with REST API and Keycloak auth for time tracking (timed), a Home Assistant custom component (ha-toggl-track), and a Lua SDK (Qmonix). These are small reference implementations that demonstrate integration patterns. The repository serves as a one-stop guide for individuals and teams evaluating time tracking solutions, learning productivity methods, or building integrations. It cites numerous statistics and studies, but many entries are stale or incomplete (e.g., research stub pages with placeholder text). The code components are basic and not production-ready without further development.