Input Simulator

Input Simulator is a powerful yet user-friendly application for Windows, designed to automate repetitive keyboard and mouse actions. Through its clean graphical user interface (GUI), you can create and execute custom macros with ease.

This tool is perfect for a wide range of tasks.

For gamers, it can be highly effective for automating tasks in single-player games or titles without invasive anti-cheat systems. Important Disclaimer: Many modern online and competitive games (e.g., FPS titles) use advanced, kernel-level anti-cheat that is specifically designed to block all forms of input automation, including the methods used by this tool. Therefore, functionality is not guaranteed in these games, and use of this tool may be against their Terms of Service. Please use responsibly.

For professionals and power users, it can streamline tedious data entry, automate software testing, or simplify any workflow that involves repetitive clicks and keystrokes.

Built with the stable and proven Windows Forms UI framework on the modern .NET platform, Input Simulator is delivered as a single, self-contained executable file. It requires no installation, has no external dependencies, and runs on any modern Windows 10 or 11 system.

Key Features

• Keyboard & Mouse Simulation: Automate both keyboard presses and mouse clicks ({M1} - {M5}).
• Multiple Automation Modes:
  • Hold: Holds down all specified keys/buttons for a set duration.
  • Repeat: Repeatedly presses and releases keys/buttons.
  • Sequencer: Executes a series of steps, each with its own set of inputs.
• Configurable Timings: Fine-tune action durations, repeat intervals, and post-step delays.
• Flexible Stop Conditions: Stop automation manually with a global hotkey or automatically after a set duration.
• Dark Mode Support: Automatically syncs with your Windows 10/11 theme for a seamless look.
• Fully Portable: Deployed as a single, self-contained .exe that runs on any modern Windows machine without installation.
• Locale-Aware Formatting: Automatically uses the correct decimal separator (e.g., . or ,) based on your Windows regional settings.

Getting Started

No installation is required.

1. Go to the Releases page of this repository.
2. Download the latest InputSimulator.exe file from the "Assets" section.
3. Run the executable. That's it!

How to Use

The application is divided into several sections:

Action Mode

Choose how the inputs should be executed.

• Hold Down (for Games): Presses and holds all specified keys/buttons simultaneously for the Action Duration.
• Repeat Keys (for Text): Rapidly presses and releases the keys/buttons. The speed is controlled by the Repeat Interval.
• Macro Sequencer: Executes each step one by one. This mode is ideal for complex macros where order matters.

Mode Settings

Configure the timing of the actions.

• Action Duration (sec): How long the Hold or Repeat mode should last for each step. (Not used in Sequencer mode).
• Delay after Step (sec): A pause to wait after each step in the sequence is completed.
• Repeat Interval (ms): The time in milliseconds between each key press in Repeat mode. A smaller value means faster typing.

Cycles / Steps

Define the sequence of inputs.

• Number of Cycles / Steps: Sets how many steps are in your sequence. The input fields below will update automatically.
• Step X Keys: The input field for each step. Enter the keys and mouse clicks you want to perform in this step according to the syntax below.

Start / Stop Behavior

Configure how to start and stop the automation.

• Start delay (sec): Sets a countdown in seconds before the automation begins after you click "Start" or use the hotkey. This gives you time to focus the correct window.
• Run duration (min): Defines a maximum total runtime in minutes. The automation will stop automatically when this time elapses. A value of 0 means the automation will run indefinitely.
• Hotkey / HK-Modifier: This section works together with the "Register Hotkey" button below the main controls.
  1. First, define your desired global hotkey combination (e.g., F12 + Ctrl).
  2. Click the Register Hotkey button. Its text will change to Unregister Hotkey to show that it is active system-wide.
  3. The hotkey now acts as a global toggle for the automation. Press it once to start the sequence; press it again while it's running to stop it.

Note: The decimal separator used in all fields (e.g., 5.00 vs 5,00) will automatically match your local Windows settings.

Syntax Guide

Inputs for each step are entered as a continuous string without separators.

Type	Syntax Examples	Description
Normal Keys	w, a, s, d, 1, abc	Standard alphanumeric keys are typed as they are. Case-insensitive.
Special Keys	{F1}, {ENTER}, {CTRL}, {SHIFT}	Use curly braces {} for non-printable keys. Most keys from the Keys enum are supported.
Mouse Buttons	{M1}, {M2}, {M3}, {M4}, {M5}	Use {MX} for mouse buttons: M1 (Left), M2 (Right), M3 (Middle), M4 & M5 (Side buttons).
Combined	w{M1}{CTRL}	This sequence would: hold/press 'W', hold/click the left mouse button, and hold/press 'Ctrl'.

Building from Source

If you want to build the project yourself:

1. Prerequisites:
   • .NET 9 SDK or later.
   • Visual Studio Code or another C# IDE.
2. Clone the repository:

   git clone [https://github.com/RaionFuyu/InputSimulator.git](https://github.com/Your-Username/InputSimulator.git)
   cd InputSimulator

3. Build:
   • Open the .sln file in Visual Studio and build the project.
   • Or, run dotnet build -c Release from the command line.
4. Publish a single .exe:
   • To create the portable executable, run the publish command:

   dotnet publish -c Release

   • You will find the final InputSimulator.exe in the \bin\Release\net9.0-windows\win-x64\publish directory.

Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

License

This project is licensed under the MIT License - see the LICENSE file for details.