Release Notes - Focusd

Highlights & New Features

Context-Aware & Dynamic KPIs

• Smart Range Metrics: The Statistics page now features a dynamic KPI summary bar that contextually adapts based on the active time range:
  • Today View: Highlights Today's Screen Time, Active Apps, App Launch count, and your Top App.
  • Last 7 Days: Shows 7-Day Total Screen Time, Daily Average, Peak Usage Day (with exact date & duration), and Total App Launches.
  • Last 30 Days: Displays 30-Day Total, 30-Day Daily Average, Recent 7-Day Total, and Peak Usage Day.
  • Custom Range: Provides Total Range Screen Time over $N$ days, Range Daily Average, Peak Day, and App Launch totals.
• Enhanced Overview Panel: The Dashboard's Today & Overview panel now displays total daily screen time, trend comparison vs. yesterday, 7-day total, 7-day daily average, active apps, app launches, and time limits hit.

UI & Chart Improvements

Responsive History Chart & Layout Engine

• No More Overlapping or Text Clipping: Fixed history chart text collisions and missing gaps when selecting long date ranges (30 days, 60 days, 90+ days, or multi-month custom ranges).
• Adaptive Column Layout & Bucketing:
  • Automatically maintains readable column widths and formatted MM/DD date labels for daily views.
  • Intelligently groups data into structured weekly/periodic buckets for long date ranges, keeping vertical bar height, date ranges (MM/DD-MM/DD), and total hours crisp and readable.

Explicit Downloads Directory Exports

• Direct Downloads Export: CSV and JSON data exports are now saved directly to your system's Downloads folder (Downloads/focusd_export.csv and Downloads/focusd_export.json).
• Clear Location Indicators: Updated settings UI and toast notifications explicitly notify you of the export destination.

Key Features

• Introduced modularity improvements in the Text User Interface (TUI) to enhance user interaction.
• Added new functionalities across various Command Line Interface (CLI) components, including autostart capabilities, browser enhancements, and retention management features.
• Enhanced tracking capabilities with the addition of a new tracker module, improving data collection and analysis.
• Implemented a new notification system aimed at increasing user engagement and interaction.
• Expanded the installer with new configuration options and improved installation processes for a smoother setup experience.
• Added functionality for managing release notes, facilitating better communication of updates and changes.

Bug Fixes

• Resolved various issues related to session management and retention, improving overall stability and user experience.
• Fixed bugs within the CLI components that previously affected functionality and user interactions.

Technical Improvements

• Refactored core components to achieve better modularity and maintainability, particularly focusing on the tracker and session management systems.
• Improved code organization throughout CLI and core modules to enhance readability and reduce complexity, making future development more efficient.
• Updated dependencies in go.mod to ensure compatibility with the latest libraries and frameworks, supporting a more robust development environment.

Key Features

• Introduced new CLI components for enhanced functionality, including autostart, tracking, and stats management.
• Added support for the Pomodoro technique with dedicated functionality in cli/pomodoro.go.
• Implemented a notification system in core/notifications.go.
• Enhanced session management with new features in storage/sessions.go.
• Added a new release notes feature in cmd/release_notes/main.go.
• Improved focus tracking capabilities in core/tracker.go.

Bug Fixes

• Addressed various bugs and issues as part of the bugfix pull request, leading to improved stability across the CLI and core functionalities.
• Resolved issues related to session retention and management in storage/retention.go.

Technical Improvements

• Refactored existing code for better organization and maintainability, particularly in the core and cli directories.
• Improved the structure of core/tracker.go to enhance performance and readability.
• Updated dependencies in go.mod to ensure compatibility with the latest libraries.
• Consolidated and optimized code in cmd/focusd and cmd/focusd_daemon for better execution efficiency.

Key Features

• Introduced new CLI components for autostart, browser management, and menu management, enhancing user interaction.
• Added functionality for tracking and managing user sessions and retention, providing insights into user engagement.
• Enhanced the Pomodoro timer implementation with additional features to improve productivity.
• Implemented a comprehensive statistics tracking system for better data analysis.
• Developed a notification system for user alerts, ensuring timely information delivery.
• Improved configuration management with a new user configuration module, allowing for easier customization.
• Added support for Windows and other operating systems in daemon and console management, broadening platform compatibility.

Bug Fixes

• Resolved various issues related to session management and data retention, improving overall reliability.
• Fixed bugs in the tracking and statistics modules to ensure accurate data reporting and analysis.

Technical Improvements

• Refactored core components for better modularity and maintainability, including the tracker and aggregator, leading to a more robust architecture.
• Improved code organization across CLI and core modules, resulting in cleaner and more efficient code.
• Updated dependency management in go.mod to reflect new changes and optimizations, ensuring a more stable development environment.
• Enhanced test coverage for the tracker component to ensure reliability and performance, contributing to higher code quality.

use focusd update in cli for updating from previous version instead of TUI. TUI direct update functionality will be fixed by next version.

What's Changed

• Refactor codebase, optimize performance, and fix configuration issues by @0xarchit in #5

Full Changelog: v2.0.1...v2.1.0

Key Features

• Introduced new CLI commands and functionalities across various modules to enhance user interaction and control.
• Added support for the GitHub Releases API by standardizing RepoName casing to lowercase.
• Expanded core functionalities with new features in the aggregator, app groups, notifications, and tracker modules.
• Enhanced session management and retention features within the storage module.
• Improved user experience with updates to the CLI interface and menu options.

Bug Fixes

• Corrected the casing of RepoName to ensure compatibility with the GitHub Releases API, guaranteeing proper functionality.
• Addressed various bugs and inconsistencies across the CLI and core modules, resulting in improved overall stability.

Technical Improvements

• Refactored multiple files for better organization and readability, particularly within the CLI and core modules.
• Improved code structure and modularity in the storage and system components.
• Updated dependencies in go.mod to ensure compatibility with the latest libraries and frameworks.

Clean install is recommended.

• Feature: NSIS installer (focusd_setup.exe) with auto PATH setup
• Feature: Standalone installer adds focusd to PATH automatically
• Feature: Windows Add/Remove Programs support with proper uninstaller
• Architecture: Go 1.26 minimum requirement
• Architecture: Auto-update now downloads raw binary from releases
• Security: SHA256 checksum verification for downloaded binary (focusd.exe); installer checksum published for manual verification
• Security: Removed UPX compression (prevents AV false positives)
• Improved: Website updated with current CLI commands and features
• Improved: README badges updated to for-the-badge style
• Improved: Installer version now matches release tag
• Feature: New Interactive UI (added mouse hover, mouse click navigation, and fixed key controls)
• Architecture: Dual-binary structure (focusd.exe for CLI/TUI, focusd_daemon.exe for windowless background tracking)
• Performance: Extreme RAM optimization (daemon footprint reduced to 4-6MB via custom SQLite pragmas)
• Autostart: Switched to native Windows Registry Run key autostart for silent background execution
• Fixed: Removed terminal popups/ghost window flashes on system boot
• Fixed: Robust uninstaller force-terminates running daemon during cleanup
• Feature: Dynamic 'Vs Yesterday' screen time trend calculation on Dashboard

• Fixed: 'Not initialized' showing after pause/resume (DB connection issue)
• Improved: Password Settings moved from Focus Tools to Settings menu

• Fixed: Concurrent map write panic (added mutex for thread safety)
• Fixed: Fork-safe updater (version URL now dynamic)
• Fixed: Notification stacking (no more AFK message boxes piling up)
• Fixed: Strip notification counts from tab titles (avoids duplicate entries)
• Fixed: LibreWolf browser name typo (was 'liberwolf')
• Fixed: Emoji crash in table display (proper Unicode handling)
• Improved: (4), [4], {4} patterns removed from start/end of browser titles
• Improved: Database connection limit (10 conns for better WAL concurrency)
• Improved: SQLite cache increased to 2MB (faster stats queries)
• Improved: Incremental VACUUM for automatic space reclamation

• Feature: Star on GitHub menu option (opens repo in browser)
• Security: SHA256 checksum verification for auto-updates
• Performance: Native process termination (removed taskkill dependency)
• Performance: Faster window title cleaning (removed regex in hot path)
• Fixed: Database concurrency (WAL now works with concurrent read/write)
• Fixed: Break reminder timer resets only when user acknowledges

• Feature: Actionable Notifications (OK to snooze, Cancel to dismiss)
• Feature: Configurable Snooze Duration (default 60min, adjustable in menu)
• Feature: Break Reminder repeats every interval
• Feature: App Limit notifies on each switch to over-limit app
• Feature: Password Recovery via 'focusd reset-password' command
• Improved: Dead code cleanup and optimized ExtractAppCategory