{"id":35408539,"url":"https://github.com/samera2022/mousemacros","last_synced_at":"2026-02-12T17:03:54.645Z","repository":{"id":303076964,"uuid":"1014347836","full_name":"Samera2022/MouseMacros","owner":"Samera2022","description":"A Java-based simple mouse macros app.","archived":false,"fork":false,"pushed_at":"2026-02-06T15:16:04.000Z","size":2042,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-06T21:32:59.098Z","etag":null,"topics":["auto-click","auto-clicker","auto-clicker-macro-recorder","auto-clicking","mouse-emulation","mouse-recorder","mouse-tracking","mousemacro"],"latest_commit_sha":null,"homepage":"https://samera2022.github.io/posts/Projects/MouseMacros/mousemacrosreadme/","language":"Java","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/Samera2022.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-05T14:42:10.000Z","updated_at":"2026-02-06T15:16:09.000Z","dependencies_parsed_at":"2025-07-05T15:23:33.123Z","dependency_job_id":"4dd3cc59-5315-492c-9d2a-0583d9e672d6","html_url":"https://github.com/Samera2022/MouseMacros","commit_stats":null,"previous_names":["samera2022/mousemacros"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/Samera2022/MouseMacros","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samera2022%2FMouseMacros","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samera2022%2FMouseMacros/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samera2022%2FMouseMacros/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samera2022%2FMouseMacros/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Samera2022","download_url":"https://codeload.github.com/Samera2022/MouseMacros/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samera2022%2FMouseMacros/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29373837,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["auto-click","auto-clicker","auto-clicker-macro-recorder","auto-clicking","mouse-emulation","mouse-recorder","mouse-tracking","mousemacro"],"created_at":"2026-01-02T13:24:11.481Z","updated_at":"2026-02-12T17:03:54.640Z","avatar_url":"https://github.com/Samera2022.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MouseMacros\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Samera2022/MouseMacros/main/docs/images/MouseMacrosIcon.png\" alt=\"MouseMacros Logo\" width=\"120\"\u003e\n  \u003cbr\u003e\n  \u003cb\u003eA lightweight, cross-platform Java tool for recording and replaying mouse and keyboard macros.\u003c/b\u003e\n  \u003cbr\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Java-1.8%2B-orange.svg\" alt=\"Java Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-GPL--3.0-blue.svg\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/Samera2022/MouseMacros\" alt=\"Latest Release\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/Samera2022/MouseMacros?include_prereleases\u0026label=pre-release\u0026color=orange\" alt=\"Pre-Release\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/Samera2022/MouseMacros/release.yml?label=CI/CD\" alt=\"Build Status\"\u003e\n  \u003ca href=\"https://deepwiki.com/Samera2022/MouseMacros\"\u003e\u003cimg src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n| \u003csub\u003eEN\u003c/sub\u003e [English](./README.md) | \u003csub\u003eZH\u003c/sub\u003e [中文](docs/zh/README_ZH_CN.md) |\n|--------------------------------------|------------------------------------------|\n\n\u003c/div\u003e\n\n## Preview\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/MouseMacrosMainFrame.png\" width=\"400\" alt=\"Main Interface\"\u003e\n\u003cbr\u003e\n  \u003csub style=\"font-size: 14px;\"\u003e\u003ci\u003eThe main interface of MouseMacros.\u003c/i\u003e\u003c/sub\u003e\n\u003c/p\u003e\n\n## Features\n\n* **Comprehensive Recording**: Capture Mouse Left/Right/Middle clicks, Scroll Wheel movements, and Keyboard inputs seamlessly.\n* **Global Hotkeys**: Control the application even when it's minimized. Fully customizable keys for:\n    * Start/Stop Recording\n    * Play Macro\n    * Abort Operation (Emergency stop for runaway macros)\n* **Multi-Language Support**: Built-in localization for **English (US)** and **Simplified Chinese**, other supported languages includes Japanese, Russian, Korean, Spanish and French.\n* **Theme Engine**: Supports **Light** and **Dark** modes, with an option to follow system settings automatically.\n* **Persistence**: Macros are saved as `.mmc` (CSV-formatted) files, allowing for easy sharing and manual editing.\n* **Smart Memory**: Remembers window sizes, last-used directories, and custom configurations across sessions.\n* **Floating Tooltip**: Shows helpful instructions and tips near the cursor for easier operation.\n\n## Security \u0026 Binary Integrity\nTo ensure the safety and authenticity of our Windows binaries, MouseMacros is currently integrating with SignPath Foundation for free code signing.\n- Status: Application in progress / Integration pending.\n- Future Releases: Once approved, all Windows installers (.msi) and executables (.exe) will be digitally signed by SignPath Foundation.\n![alt text](https://img.shields.io/badge/Code%20Signing-SignPath.io-blue)\n\n## Getting Started\n\n### Quick Launch\nI. Jar User\n1. Make sure that you have installed JRE 1.8 or above. If not, you can download [HERE](https://www.oracle.com/technetwork/cn/java/javase/downloads/jre8-downloads-2133155-zhs.html).\n2. Download the latest `.jar` file from the [Releases](https://github.com/Samera2022/MouseMacros/releases) page.\n3. Double-click the jar file OR use cmd to run the application:\n    ```bash\n    java -jar MouseMacros.jar\n    ```\nII. Exe User\n1. Download the latest `.exe` file from the [Releases](https://github.com/Samera2022/MouseMacros/releases) page.\n2. Click to start! All environments are integrated into one `exe` file!\n\n### Usage\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/MouseMacrosSettingsDialog.png\" width=\"400\" alt=\"Settings Dialog\"\u003e\n\u003c/p\u003e\n\n1. **Adjust**: The choose of language will determine the words in the frame, thus resulting in some buttons not being displayed in the frame.\n   In this case, you will need to adjust the frame to the appropriate size.\n2. **Configure**: Open the Settings dialog and Macros Settings dialog to set your preferred hotkeys. For detailed configuration docs, please refer to [Configuration](#configuration).\n3. **Record**: Press your \"Start Recording\" hotkey or press this button in the frame and perform the actions.\n4. **Save**: Use \"Save Macros\" to export your recording to a `.mmc` file.\n5. **Replay**: Use \"Load Macro\" to load a `.mmc` file and press \"Play Macro\".\n\n## Configuration\n\nThe application stores settings in the user's AppData directory:\n`%USERPROFILE%/AppData/MouseMacros/`\n\n| File         | Description                                                             |\n|:-------------|:------------------------------------------------------------------------|\n| `config.cfg` | Stores UI language, theme mode, key mappings, and default storage path. |\n| `cache.json` | Stores recent file paths and window dimensions.                         |\n\n### Settings Dialog Options\n| Name                             | Key                             | Description                                                                                                                                                                                                                                                                                                                           |\n|:---------------------------------|:--------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Follow System Settings           | `followSystemSettings`(boolean) | Controls whether to follow System default settings or not.                                                                                                                                                                                                                                                                            |\n| Switch Language                  | `lang`(String)                  | If `followSystemSettings` is false, you can use this combo box to choose another display language.                                                                                                                                                                                                                                    |\n| Enable Dark Mode                 | `enableDarkMode`(boolean)       | If `followSystemSettings` is false, you can use this check box to choose whether to enable Dark Mode.                                                                                                                                                                                                                                 |\n| Enable Default Storage           | `enableDefaultStorage`(boolean) | Controls whether to enable `defaultMmcStoragePath`. If it is true, the `lastSaveDirectory` and `lastLoadDirectory` in cache.json will be ignored. Every time you open the FileChooserDialog(in \"Save Macro\" and \"Load Macro\"), it will automatically open the folder with `defaultMmcStoragePath`. The same applies in reverse.       |\n| Default MouseMacros Storage Path | `defaultMmcStoragePath`(String) | If `followSystemSettings` is true, it will determine the default folder everytime you open the FileChooserDialog(in \"Save Macro\" and \"Load Macro\"). If the folder in this option doesn't exist, the app will first attempt to create this folder, otherwise it will automatically open the default folder(Your User Document Folder). |\n| Enable Quick Mode                | `enableQuickMode`(boolean)      | Controls whether to enable no-delay mode. In this mode, MouseMacros will ignore the waiting time between each mouse/keyboard action. It is DANGEROUS, and it is STRONGLY ADVISED to set a proper **Abort Operation** Hotkey and the **Repeat Delay** in **Macro Settings Dialog** before you enable this mode.                        |\n| Allow Long Tooltip               | `allowLongStr`(boolean)         | Controls whether to enable LongTooltip Display. If false, MouseMacros will display all tooltips in a given width, otherwise MouseMacros will attempt to display them in a long line unless exceeding the frame (if so, it will wrap lines and display it in two or more long lines).                                                  |\n| Readjust Frame Mode              | `readjustFrameMode`(String)     | Controls the mode to display the window at a 3:2 ratio when there is no cache. If a cache exists, after changing the language, MouseMacros can choose among the three modes from the previous step when processing 'historical window size' and 'recommended window size'. You will get more detailed information in tooltip.         |\n\n### Macro Settings Dialog Options\n| Name                             | Key                                  | Description                                                                                                                                                    |\n|:---------------------------------|:-------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Enable Custom Macro Settings     | `enableCustomMacroSettings`(boolean) | Controls whether to enable custom macro settings.                                                                                                              |\n| Execution Repeat Times           | `repeatTime`(int)                    | If `enableCustomMacroSettings` is true, MouseMacros will automatically repeat your Macro at the given times.                                                   |\n| Repeat Delay (s)                 | `repeatDelay`(double)                | If `enableCustomMacroSettings` is true, MouseMacros will postpone given time before the next execution. Supports three decimal places(to millisecond) at most. |\n\n## Development Document\n\nDetailed docs generated by DeepWiki is presented in [GitHub Wiki](https://github.com/Samera2022/MouseMacros/wiki). Notably, it may be outdated, since it was manually compiled by the author from DeepWiki.\n\nFor more up-to-date documents, you can refer to [Samera2022/MouseMacros | DeepWiki](https://deepwiki.com/Samera2022/MouseMacros) or just click the badge at the top of the article. The website weekly updates this project's docs and provides a \"Refresh this wiki\" with \"Enter email to refresh\" button to force update the docs if it hasn't indexed yet.\n\nAdditionally, for internal development details such as versioning conventions, changelog maintenance, and CI/CD workflows, please refer to our Development [FAQ](docs/en/FAQ_EN.md).\n\n## Others\n\n### Contributing\nContributions are welcome! If you find a bug or have a feature request, please open an issue.\n### Author\n**Developer: Samera2022**\n* **GitHub**: [@Samera2022](https://github.com/Samera2022)\n### License\nThis project is licensed under the GNU General Public License v3.0 License - see the `LICENSE` file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamera2022%2Fmousemacros","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamera2022%2Fmousemacros","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamera2022%2Fmousemacros/lists"}