{"id":22941573,"url":"https://github.com/robthepcguy/ahk-mouse-heatmap","last_synced_at":"2025-04-01T20:49:04.597Z","repository":{"id":239520824,"uuid":"799755339","full_name":"RobThePCGuy/AHK-Mouse-Heatmap","owner":"RobThePCGuy","description":"An AutoHotkey script that records left, right, and middle mouse clicks, logging the date, time, and x and y coordinates. It features automatic GUI updates and generates a visual heatmap via a Python script, accessible from the system tray. This tool is ideal for analyzing user interaction and creating detailed mouse activity maps.","archived":false,"fork":false,"pushed_at":"2024-08-24T05:19:44.000Z","size":2820,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T10:59:54.695Z","etag":null,"topics":["autohotkey-script","click-counter","click-log","click-map","data-analysis","data-visualization","heatmap","heatmap-visualization","mouse-events","mouse-tracking","python"],"latest_commit_sha":null,"homepage":"","language":"AutoHotkey","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RobThePCGuy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-13T03:11:57.000Z","updated_at":"2025-02-08T02:34:02.000Z","dependencies_parsed_at":"2024-06-07T06:02:51.650Z","dependency_job_id":null,"html_url":"https://github.com/RobThePCGuy/AHK-Mouse-Heatmap","commit_stats":null,"previous_names":["zeroonezero/ahk-mouse-heatmap","robthepcguy/ahk-mouse-heatmap"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FAHK-Mouse-Heatmap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FAHK-Mouse-Heatmap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FAHK-Mouse-Heatmap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FAHK-Mouse-Heatmap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RobThePCGuy","download_url":"https://codeload.github.com/RobThePCGuy/AHK-Mouse-Heatmap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246709914,"owners_count":20821298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autohotkey-script","click-counter","click-log","click-map","data-analysis","data-visualization","heatmap","heatmap-visualization","mouse-events","mouse-tracking","python"],"created_at":"2024-12-14T13:44:22.248Z","updated_at":"2025-04-01T20:49:04.578Z","avatar_url":"https://github.com/RobThePCGuy.png","language":"AutoHotkey","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AHK-Mouse-Heatmap\n\nThis AutoHotkey script logs the date, time, and x/y coordinates of individual left, right, and middle mouse clicks. It offers automatic GUI updates and can create a visual heatmap from the system tray or the GUI using Python. I use this tool just for fun. This repo may be used in your own projects, for profit or loss, but I do not accept liability for either.\n\n![Screenshot of GUI](https://github.com/RobThePCGuy/AHK-Mouse-Heatmap/assets/10876982/77c75132-e751-4e19-9312-a2767563a026)\n![Screenshot of Heatmap](https://github.com/RobThePCGuy/AHK-Mouse-Heatmap/assets/10876982/483dd7ab-f5a8-4594-8bb4-91f4a556faa7)\n\n## Features\n\n- **Easy Logging**: Automatically logs the date, time, and x/y coordinates of individual left, right, and middle mouse clicks.\n- **Smart Analysis**: Pinpoints hotspots by clustering frequently clicked areas.\n- **Visual Heatmap**: See where you click most with a colorful heatmap.\n- **Live Click Count**: View live stats from the GUI, where you can also create a heatmap.\n- **Tray Menu**: Show the GUI, create a heatmap, or close the script from the tray menu.\n\n## Prerequisites\n\nBefore you get started, make sure you have:\n\n- [AutoHotkey](https://www.autohotkey.com/) installed to run AHK scripts.\n\n    \u003e You may download and install [v2 AHK](https://www.autohotkey.com/download/ahk-v2.exe) since the application detects v1 scripts and will automatically install v1.\n\n- [Python](https://www.python.org/downloads/) 3.8 or later.\n\n   \u003e Installation of `requirements.txt` (see below for steps) or just run `pip install pandas Pillow numpy scikit-learn`.\n\n## Getting the Files:\n\nTo get started, download the zip file using the green button above or clone the repository to your local machine:\n\n```bash\n# Steps to clone repo locally\ngit clone https://github.com/RobThePCGuy/AHK-Mouse-Heatmap.git\ncd AHK-Mouse-Heatmap\n```\n\n\u003e [!IMPORTANT]\n\u003e If you're using `git clone` on Windows, you'll need [Git for Windows](https://git-scm.com/download/win) or [GitHub Desktop](https://desktop.github.com/download/).\n\n## Installation\n\nInstall the necessary Python libraries:\n\n```bash\npip install -r requirements.txt\n# or pip install pandas Pillow numpy scikit-learn\n```\n\n## Usage\n\nTo start logging clicks, run `heatmap.ahk`.\n\nAfter a few clicks, you are ready to generate a visual heatmap of the clustered areas you've been clicking. Do this via the GUI, found in the tray menu, or by clicking `Run Heatmap` from the tray menu.\n\nA new file, **heatmap.png** will be saved in the project directory.\n\nTo exit out of the script and stop logging, right-click the tray icon and select the `Exit` option.\n\n![tray](https://github.com/user-attachments/assets/f1299b25-ef1e-417e-abec-6acafbd16ac2)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthepcguy%2Fahk-mouse-heatmap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobthepcguy%2Fahk-mouse-heatmap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthepcguy%2Fahk-mouse-heatmap/lists"}