Chronos ⌛

Your intelligent productivity suite that enhances focus and digital awareness

🎯 Overview

Chronos is a versatile productivity toolkit designed to help you work smarter and maintain focus in your digital environment. It combines process tracking, window management, focus enhancement tools, and productivity features through an intuitive command system. Whether you're coding on LeetCode, analyzing your application usage patterns, or trying to maintain focus, Chronos provides the tools you need while staying lightweight and unobtrusive.

✨ Key Features

• Process Usage Tracking - Real-time monitoring of application usage with precise timing
• Current Window Tracking - Detailed information about the active window including PID, process name, and window title
• Window Switch Detection - Logs window switching events with timestamps to track focus changes
• LeetCode Focus Mode - Helps maintain focus during LeetCode problem-solving by automatically closing non-LeetCode tabs
• Command System - Flexible command input system using a trie-based implementation
• GUI Dashboard - Multiple clean interfaces for process stats, window tracking, and switch logs
• Desktop Notifications - Native system notifications for important events and updates
• Background Monitoring - Runs quietly in the background while tracking your activity

🛠 Tech Stack

• Python 3.12+
• Key Libraries:
  • psutil - Process and system monitoring
  • pynput - Keyboard input handling
  • desktop-notifier - System notifications
  • pywin32 - Windows API integration
  • tkinter - GUI implementation
  • playwright - Browser automation for LeetCode focus mode
  • requests - HTTP client for browser debugging

🔧 Installation

1. Clone the repository:

git clone https://github.com/yourusername/chronos.git
cd chronos

2. Install UV if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

4. Sync local environment with UV:

uv sync

💻 Usage

1. Start Chronos:

uv run main.py

2. Available commands:

• ;;process-usage= - Opens the process tracking dashboard showing application usage times
• ;;current-window= - Shows real-time details about the active window
• ;;switch-detection= - Opens a window switch log showing focus changes with timestamps
• ;;leet-focus= - Activates LeetCode focus mode to maintain concentration while solving problems

3. Press ESC to clear the command buffer at any time

🏗 Architecture

Chronos uses a multi-threaded architecture:

• Main thread handles keyboard input and command processing
• Separate thread for process monitoring
• Asyncio event loop for command execution
• GUI runs in its own thread for smooth updates