A system tray app that visualizes your keyboard usage as a glowing heat map.
Download Latest Release ... No installation required, just run the exe!
Download KeyboardHeatMap.exe from Releases and run it.
git clone https://github.com/semihsmg/heat-map.git
cd heat-mapA) Double-click run.bat (auto-installs dependencies & checks for updates)
B) Manual install
pip install -r requirements.txt
pythonw main.pyw| Feature | Description |
|---|---|
| Heat Map Visualization | Keys glow brighter based on usage intensity |
| Top 3 Highlight | Most used keys shine purple |
| Top 10 Keys | See your most pressed keys at a glance |
| Screenshot Export | Download your heat map as PNG |
| Auto-Update | Check for updates from the tray menu |
| System Tray | Runs in background, right-click for menu |
| Pause/Resume | Toggle logging anytime |
| Startup Option | Auto-launch with Windows |
| Single Instance | Prevents duplicate app instances |
Your data stays on your machine. Period.
- 100% offline — No internet connection, no analytics, no telemetry
- Local storage only — Everything stored in
%APPDATA%/KeyboardHeatMap/ - No keystroke content — Only counts which keys, not what you typed
- Aggregated daily totals — No individual timestamps, just daily summaries
- You control your data — Delete the database anytime to reset
App doesn't start / No tray icon appears
- Ensure Python 3.8+ is installed
- Run
pip install -r requirements.txtagain - Try running with
python main.pywto see error messages
Heat map shows no data
- The app only logs keys while running — check it's not paused
- Verify the database exists at
%APPDATA%/KeyboardHeatMap/keystrokes.db
Keys aren't being captured
- Some antivirus software blocks keyboard hooks — add an exception
- Run as administrator if issues persist
- Check the tray icon isn't grayed out (paused state)
How do I reset my data?
Delete the database file:
%APPDATA%/KeyboardHeatMap/keystrokes.db
Where is my data stored?
All data is stored locally in %APPDATA%/KeyboardHeatMap/. Nothing is transmitted anywhere.