What is keymousego?

taojy123/keymousego — explained in plain English

Analysis updated 2026-06-24

★ 10,191PythonAudience · generalComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((KeymouseGo))
    What it does
      Records actions
      Replays macros
    Features
      Mouse clicks
      Keyboard input
      JSON script files
    Platforms
      Windows
      macOS
      Linux
    Use Cases
      Form automation
      Repetitive tasks
    Setup
      Standalone exe
      Python source

mindmap root((KeymouseGo)) What it does Records actions Replays macros Features Mouse clicks Keyboard input JSON script files Platforms Windows macOS Linux Use Cases Form automation Repetitive tasks Setup Standalone exe Python source

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Record a sequence of clicks and keystrokes once, then replay it hundreds of times to fill out repetitive forms.

USE CASE 2

Automate a repetitive data entry workflow on Windows, Linux, or macOS without writing any code.

USE CASE 3

Edit a saved JSON script file to fine-tune timing or click coordinates for a recorded macro.

USE CASE 4

Run a recorded macro from the command line as part of a larger automated workflow.

What is it built with?

Python

How does it compare?

	taojy123/keymousego	pypa/pip	aigc-audio/audiogpt
Stars	10,191	10,192	10,188
Language	Python	Python	Python
Setup difficulty	easy	easy	hard
Complexity	2/5	1/5	4/5
Audience	general	developer	researcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

On Mac and Linux, administrator permissions may be required to capture all input events.

No license information is mentioned in the explanation.

So what is it?

KeymouseGo is a desktop automation tool that records what you do with your mouse and keyboard, then plays it back for you automatically. Think of it as a simple macro recorder: you press Record, do a task on your computer (clicking buttons, typing text, navigating menus), press Stop, and from then on the program can repeat those exact same steps as many times as you want. The primary use case is repetitive work. If you find yourself doing the same sequence of actions over and over, KeymouseGo can take over after you do it once. You can set it to repeat a fixed number of times or loop indefinitely. The default keyboard shortcuts are F6 to start a replay and F9 to stop it, though you can customize these. It works on Windows, Linux, and macOS. The tool records mouse clicks and keyboard presses but does not record mouse movement paths between clicks. Each recording session is saved as a small script file in JSON format inside a scripts folder. These files can be edited by hand if you want to fine-tune the timing or adjust coordinates, and the format is documented in the README. You can also run scripts directly from the command line without opening the graphical interface. KeymouseGo is written in Python and comes packaged as a standalone executable for users who do not have Python installed. Those who do have Python can install the dependencies and run or build it from source. On Mac and Linux, some systems may require running the tool with administrator permissions for it to capture all input events correctly.

Copy-paste prompts

Prompt 1

I recorded a macro with KeymouseGo and saved it as a JSON script. Help me edit the JSON to change the click coordinates and add a 500ms delay between steps.

Prompt 2

I want to use KeymouseGo to automate a form submission that repeats 200 times. Write me a command-line invocation that runs the script 200 times and logs which iterations complete.

Prompt 3

How do I install KeymouseGo from source on macOS and run it with the right permissions so it can capture all keyboard and mouse events?

Prompt 4

Help me write a Python script that programmatically generates a KeymouseGo JSON macro file for clicking a grid of 10x10 buttons in a desktop app.

Frequently asked questions