A modern, kernel-level auto clicker for Linux.
-lightgrey){kind=icon}
I needed a proper auto-clicker for Linux that worked on Wayland without relying on ancient X11 hacks or clunky scripts. Moonlight is a feature-rich tool that uses the kernel's uinput system to create a virtual mouse device.
It should work out of the box on both Wayland (Hyprland, GNOME, KDE) and X11. It also features humanized timing and randomized jitter, making it perfect for both desktop automation and Minecraft PvP.
- Kernel-Level Input: Instead of sending software signals, Moonlight creates a virtual device in
/dev/uinput. To the OS and games, it looks identical to a real physical mouse. - Process Cloaking: The background daemon actively renames itself to
kworker/u12:0(a common kernel thread) so it blends intohtopand task managers. - Biological Timing: It doesn't just use random numbers. The engine cycles through "cruising", "burst", and "tired" states using Gaussian distribution to mimic actual human muscle fatigue and reaction speeds.
- PvP Assist: Built-in logic for W-Tapping (sprint resetting) and Blockhitting (animation canceling) that weaves seamlessly into the click stream.
- Asynchronous Architecture: The click engine runs in a completely separate process from the UI. You can drag the window around or minimize it, and the click rate will never stutter.
Moonlight comes with a smart installer that handles system dependencies, creates the necessary permissions, and adds the app to your desktop menu.
# Clone the repository
git clone https://github.com/oNxZero/Moonlight.git
# Enter the directory
cd Moonlight
# Make the installer executable
chmod +x install.sh
# Run the universal installer and wait for it to finish
./install.shNote: You must Log Out after installing. The script creates a new hardware permission rule so you don't have to run the app as root.
If you want to remove Moonlight, the included script will remove the desktop shortcut, config files, and system permissions for you.
# Enter the directory (if not already there)
cd Moonlight
# Make the uninstaller executable
chmod +x uninstall.sh
# Run the uninstaller
./uninstall.sh
# Finally, leave the deleted directory
cd ..Once installed, simply search for Moonlight in your application menu.
The interface is split into simple controls:
- Master Switch: The global safety. This must be ON for any clicks to register.
- Target Mode:
- Mouse: Standard auto-clicking for Left and Right mouse buttons.
- Keyboard: Spams a specific keyboard key (e.g.,
Space,F) instead of clicking the mouse.
- Trigger Mode:
- Toggle: Press key to start clicking, press again to stop.
- Hold: Clicks only while you physically hold the key down.
- Humanization:
- Legit: Adds realistic jitter and timing drift (recommended for gaming).
- Blatant: Strict timing with little variance (maximum efficiency).
You can rebind these directly in the app by clicking the button and pressing a new key.
| Key | Action | Description |
|---|---|---|
| [F6] | Left Click | Toggles the left mouse clicker. |
| [F7] | Right Click | Toggles the right mouse clicker. |
| [R-Shift] | Panic Mode | Instantly hides or shows the window. |
The settings menu allows you to manage profiles and themes without editing files.
Presets are snapshots of your configuration.
- Create: Type a name and click "Create" to save your current settings as a new preset.
- Load: Click the Play button (▶) to apply a preset's settings to your current session.
- Update: Click the Save button (💾) to overwrite an existing preset with your current settings.
- Note: The app remembers your current active settings automatically on exit, but Presets must be updated manually.
- Gallery: Click any theme name (like Dracula or Obsidian) to instantly apply that color scheme.
- Overrides: Use the color pickers to change specific elements like the Accent color or Background.
All configurations and presets are stored in:
~/.config/Moonlight/
Distributed under the MIT License. See LICENSE for more information.