{"id":16199912,"url":"https://github.com/huntfx/mousetracks","last_synced_at":"2025-04-05T00:08:35.099Z","repository":{"id":89621910,"uuid":"84234420","full_name":"huntfx/MouseTracks","owner":"huntfx","description":"Track and display mouse, keyboard and gamepad information for different applications.","archived":false,"fork":false,"pushed_at":"2025-03-22T23:26:43.000Z","size":4961,"stargazers_count":138,"open_issues_count":10,"forks_count":23,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-28T23:07:20.459Z","etag":null,"topics":["mouse-tracking","python","visualization"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huntfx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2017-03-07T18:50:41.000Z","updated_at":"2025-03-22T23:26:46.000Z","dependencies_parsed_at":"2025-01-21T21:28:06.438Z","dependency_job_id":"7e36ca2f-8ba5-4e31-99a1-a3db04007fd7","html_url":"https://github.com/huntfx/MouseTracks","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huntfx%2FMouseTracks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huntfx%2FMouseTracks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huntfx%2FMouseTracks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huntfx%2FMouseTracks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huntfx","download_url":"https://codeload.github.com/huntfx/MouseTracks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247266564,"owners_count":20910836,"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":["mouse-tracking","python","visualization"],"created_at":"2024-10-10T09:28:40.435Z","updated_at":"2025-04-05T00:08:35.073Z","avatar_url":"https://github.com/huntfx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MouseTracks\n\nMouseTracks is an application designed to track and visualize mouse movements, clicks, keyboard activity, and gamepad inputs over time. It's designed to be unobtrusive, allowing you to leave it running indefinitely - even for years - and return later to render colourful visualisations of the data.\n\n\u003cimg src=\"media/gui.jpg\"\u003e\n\n## Features\n\n- ### Live Tracking:\n  Continuously monitors mouse movements and clicks, with older movements gradually fading out to maintain a clear view of recent activity.\n\n  Keyboard heatmaps and gamepad inputs are also supported.\n\n- ### Live Preview\n  The GUI includes an optimised real-time preview of tracking data, combining thumbnail renders with live input.\n\n- ### Image Rendering:\n  Renders are generated at full quality, regardless of resolution changes. Each input type is tracked independently and merged during the render process.\n\n  - Mouse and gamepad thumbsticks: Track maps and position heatmaps.\n\n  - Mouse clicks: Heatmaps.\n\n  - Key presses: Heatmap overlaid on a keyboard image.\n\n  - _(Gamepad button rendering is not yet supported.)_\n\n- ### Colourful Renders:\n  Includes predefined and customizable color maps for all render types.\n\n- ### Application Tracking:\n  Use separate tracking profiles when different applications (defined in `AppList.txt`) are detected.\n\n  _(New applications must be added manually.)_\n\n- ### Multi-Monitor Support:\n  Tracks activity across multiple monitors. If linked to a specific application, the rendering bounds will automatically adjust to the application's window geometry.\n\n- ### Unobtrusive:\n  Designed to run silently in the background. Closing the GUI will minimise it to the System Tray, which also reduces the processing overhead.\n\n- ### Modular Design:\n  The application was designed with multiple components that communicate but run independenantly of each other, ensuring the live tracking remains fully stable, even during resource-intensive tasks like rendering or waiting on GUI operations.\n\n- ### Stability\n  Will happily keep running for years without any issues.\n---\n\n## Installation (v2.0)\n\n_Currently, only Windows is supported. Contributions for Linux or macOS support are welcome!_\n\n### Prebuilt Executable\n\nLaunch `MouseTracks.exe` from anywhere. Recommended for ease of use.\n\nBuild it using [`build-pyinstaller.bat`](build-pyinstaller.bat), or download it from the releases (available with v2.0).\n\nIt's also possible to run [`build-nuitka.bat`](build-nuitka.bat), but unless you have a commercial license, it will be flagged by a lot of AV programs, so this is generally not recommended.\n\n\n### Virtual Environment\n\nRecommended if running the code locally.\n\n1. Run `python -m venv .venv` to create the virtual environment with Python 3.11 or above.\n2. Run `launch.bat`.\n\n\n### Without a Virtual Environment\n\nRun `launch.py`.\n\nEnsure all modules in [requirements.txt](requirements.txt) are installed.\n\n---\n\n## Installation (v1.0 - Deprecated)\n\n_The v1.0 version is no longer supported, but the launch process has been updated to bring it in line with v2.0._\n\nYou will be prompted with a choice to start tracking or generate images. This can be skipped by passing the `--start-tracking` or `--generate-images` flags.\n\n### Virtual Environment\n\nRecommended if running the code locally.\n\n1. Run `python -m venv .venv-legacy` to create the virtual environment with any version of Python.\n2. Run `launch-legacy.bat`.\n\n\n### Without a Virtual Environment\n\nRun `launch-legacy.py`.\n\nEnsure all modules in [requirements-legacy.txt](requirements-legacy.txt) are installed.\n\n---\n\n## Example Output\n\u003cimg src=\"http://i.imgur.com/UJgf0up.jpg\"\u003e\n\u003cimg src=\"http://i.imgur.com/HL023Cr.jpg\"\u003e\n\n### Colour Maps\n#### Chalk\n\u003cimg src=\"http://i.imgur.com/ReRbDnF.jpg\"\u003e\n\n#### Citrus\n\u003cimg src=\"http://i.imgur.com/wRRsFhn.jpg\"\u003e\n\n#### Demon\n\u003cimg src=\"http://i.imgur.com/IDLRgGn.jpg\"\u003e\n\n#### Sunburst\n\u003cimg src=\"http://i.imgur.com/HtVF8In.jpg\"\u003e\n\n#### Ice\n\u003cimg src=\"http://i.imgur.com/KniZy9q.jpg\"\u003e\n\n#### Hazard\n\u003cimg src=\"http://i.imgur.com/zy9v3in.jpg\"\u003e\n\n#### Spiderman\n\u003cimg src=\"http://i.imgur.com/CwGlzfa.jpg\"\u003e\n\n#### Graffiti\n\u003cimg src=\"http://i.imgur.com/z1s0iTg.jpg\"\u003e\n\n#### Lightning\n\u003cimg src=\"http://i.imgur.com/yB5udPO.jpg\"\u003e\n\n#### Razer\n\u003cimg src=\"http://i.imgur.com/Xfu0i8E.jpg\"\u003e\n\n#### BlackWidow\n\u003cimg src=\"http://i.imgur.com/1AqOHxC.jpg\"\u003e\n\n#### Grape\n\u003cimg src=\"http://i.imgur.com/fcOji6t.jpg\"\u003e\n\n#### Neon\n\u003cimg src=\"http://i.imgur.com/hd8oshz.jpg\"\u003e\n\n#### Shroud\n\u003cimg src=\"http://i.imgur.com/HmP4kSJ.jpg\"\u003e\n\n## Game Genres\n#### Twin Stick\n\u003cimg src=\"http://i.imgur.com/mjxqbg0.png\"\u003e\n\u003cimg src=\"http://i.imgur.com/ZxBoz0i.jpg\"\u003e\n\u003cimg src=\"http://i.imgur.com/rikwsUa.jpg\"\u003e\n\n#### FPS\n\u003cimg src=\"http://i.imgur.com/Iocmy3N.jpg\"\u003e\n\u003cimg src=\"http://i.imgur.com/ii3mhBA.jpg\"\u003e\n\n#### RTS\n\u003cimg src=\"http://i.imgur.com/FSeAHYK.jpg\"\u003e\n\u003cimg src=\"http://i.imgur.com/Ct8A3tK.jpg\"\u003e\n\n#### MOBA\n\u003cimg src=\"http://i.imgur.com/X34ZrwQ.jpg\"\u003e\n\u003cimg src=\"http://i.imgur.com/Y5tttVN.jpg\"\u003e\n\n## Icon\nI didn't have any plan of what it might look like, so I gave a vague prompt to Copilot to see what would happen.\n\n\u003e Can you generate me an icon for my mousetracks app? It records clicks, cursor movement, keyboard presses, gamepad data, etc.\n\u003cimg src=\"media/icon.png\"\u003e\n\nThis was the first result, my partner loved it and I think it captures the essence of the application really well.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuntfx%2Fmousetracks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuntfx%2Fmousetracks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuntfx%2Fmousetracks/lists"}