mnoorchenar/focus-tracker

Focus Tracker

Windows app that times your focus sessions per project, against a plan, and shows where your time goes.

• Corner icon (bottom-right, semi-transparent): big minutes number inside a progress ring. While focusing, the ring fills toward your session plan (default 20 min, changeable): red below 50%, orange up to the plan, green with "GREAT!" once the plan is passed. Paused, it shows today's minutes and progress toward the daily goal.
• Hotkey toggles start/pause. Set any key or combination in the main window (the Copilot key works; it is suppressed so Windows will not open Copilot).
• Main window (launch the exe again, or right-click the icon > Open window): Home (live timer, project, plan, hotkey, stat cards, and the session list where you can add, edit - project, start, end, plan - or delete sessions), Daily, Projects (add / rename / delete), Charts, Settings (daily goal, idle auto-pause, start with Windows).
• Import / export CSV from the top bar. Import skips sessions that already exist, so you can safely re-import a backup.
• Closing the window hides it to the system tray (next to the clock); click the tray icon to reopen, right-click for Start/Pause/Quit. The corner icon can be dragged anywhere (position is remembered) or hidden in Settings. Window size, position and maximized state are remembered.
• Data: SQLite at %APPDATA%\FocusTracker\focus.db (project, start, end, plan per session). Crash-safe via a 30 s heartbeat. CSV export included.

Run / build

pip install -r requirements.txt
python app.py
build.bat            # creates dist\FocusTracker.exe (no console window)
# installer: compile installer.iss with Inno Setup -> installer\FocusTracker-Setup.exe

Windows 10/11, Python 3.10+.