
CrossMacro is an open-source, cross-platform mouse and keyboard macro recorder, editor, and
automation tool for Linux, Windows, and macOS. Record clicks, movement, scrolling, and keyboard
input, then edit and replay macros with configurable speed, pauses, loops, repeat counts, delays,
global hotkeys, or schedules.
Linux-first Wayland and X11 support provides compositor-aware cursor positioning and daemon-backed
or direct-device input paths. CrossMacro uses absolute mouse positioning when the active session
exposes a compatible cursor-position protocol and falls back to relative input when that capability
is unavailable. It also combines text expansion, screen-reading commands, native PNG image recognition,
profiles, themes, a GUI, and a scriptable CLI in one application.
Features:
<ul><li>Record and replay mouse and keyboard macros with configurable timing and pause/resume control</li><li>Edit macros with undo/redo, action reordering, coordinate modes, variables, loops, conditionals,
and text input</li><li>Bind macros to global hotkeys with toggle or hold-to-run modes</li><li>Schedule macros at specific times or intervals, including one-time, weekly, custom weekday,
and randomized intervals</li><li>Expand text from global shortcuts with configurable typing methods</li><li>Read screen pixels and search native PNG templates for image-based workflows</li><li>Control playback speed from 0.1x to 10x, loops, repeat counts, and fixed or randomized repeat
delays</li><li>Save, load, sequence, and replay .macro files, then switch between profiles</li><li>Customize themes and use the desktop GUI, CLI, or GUI-less runtime on Linux Wayland/X11,
Windows, and macOS</li><li>Use customizable global controls with F8 recording, F9 playback, and F10 pause as the defaults</li></ul>
Wayland and X11 support:
CrossMacro treats Wayland and X11 as first-class Linux targets and selects compositor-aware
positioning and daemon-backed or direct-device input according to the active session's capabilities.
On GNOME, a Shell Extension can be installed on first run. A logout/login may be required for
the extension to take effect.
If permissions are missing, the app offers Quick Setup on launch. Quick Setup opens a standard
system authorization prompt to enable direct device access for the current user session. If setup
cannot complete, use the direct-device troubleshooting instructions in the Linux guide's Flatpak
On Wayland section, available through the Help link.