Track your KiCad design time with WakaTime.
See Known Issues for more information.
- Tracks active KiCad windows
- Reports time spent on KiCad projects to WakaTime
- Works with KiCad schematic editor, PCB editor, and other KiCad tools
Looks at window names to determine if KiCad is active, and uses WakaTime CLI to report time spent in KiCad.
The API is very limited and inconsistent across document types. I plan to add support for KiCad IPC in the future, but for now this is the best I can do.
The script reads the KiCad config that conviniently lists the absolute path of the active project.
- Add configuration menu to set WakaTime API key and URL
- Test on other KiCad versions
- Add support for Mac and Linux
- Mouse and keyboard activity tracking
- Actually use KiCad IPC to get active window
Only works if all three KiCad files (schematic, PCB, and project) have the same name and are in the same directory.
Will not work with multiple KiCad projects open at the same time. (Will be buggy only will tack for the last opened project)
- WakaTime account with API key and URL configured
- WakaTime CLI installed (
~/.wakatime/wakatime-cli.*)
- KiCad 9.0.2
- WakaTime CLI v1.115.3
- Windows 11
- Python 3.13.2
Configuration menu will be added in the future.
Run the script in the background while using KiCad
Build or run the script youself with instructions below, or download the pre-built binary from the releases page.
Alternatively, you can use run the script directly.
- Python 3.8 or later
- pip (Python package installer)
- pyinstaller (for building the executable)
python -m venv .venv
.\.venv\Scripts\Activate.ps1pip install -r requirements.txtpyinstaller --onefile --console --paths .\.venv\Lib\site-packages .\kicad_wakatime.pyCheck the log file at ~/.wakatime/kicad-wakatime.log for any errors.
MIT