CrossMacro

Screenshots & videos

1 / 9

Close

close

About

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: 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 project README. - Record and replay mouse and keyboard macros with configurable timing and pause/resume control - Edit macros with undo/redo, action reordering, coordinate modes, variables, loops, conditionals, and text input - Bind macros to global hotkeys with toggle or hold-to-run modes - Schedule macros at specific times or intervals, including one-time, weekly, custom weekday, and randomized intervals - Expand text from global shortcuts with configurable typing methods - Read screen pixels and search native PNG templates for image-based workflows - Control playback speed from 0.1x to 10x, loops, repeat counts, and fixed or randomized repeat delays - Save, load, sequence, and replay .macro files, then switch between profiles - Customize themes and use the desktop GUI, CLI, or GUI-less runtime on Linux Wayland/X11, Windows, and macOS - Use customizable global controls with F8 recording, F9 playback, and F10 pause as the defaults

Changelog

CrossMacro 1.5.0 makes larger macro projects easier to author and test with a multi-document editor workspace, flexible image search regions, and stronger Linux runtime reliability. - Added a multi-document macro editor workspace with independent tabs, drag reordering, inline tab renaming, unsaved-change protection, and explicit Playback integration for disk-loaded macros. - Added Run Selected so a chosen subset of editor actions can be started, stopped, or cancelled without running an entire macro. - Added variable-driven left, top, width, and height image search regions for image search, image click, and wait actions. Existing endpoint-based region syntax remains compatible. - Added tray preferences that can hide the main window while recording or playback runs and restore it afterward when a system tray is available. - Launching the GUI again now activates the existing CrossMacro window instead of leaving a second desktop instance open. - Added the Jadeite and Gruvbox Sublime themes. - Raised macro script, event, file-line, and loop limits for large recordings; increased editor undo history; and allowed image matching and PNG decoding to use available CPU capacity. - Improved playback resilience by logging and continuing when an absolute cursor move cannot settle in time. - Improved Linux input recovery with temporary direct-device access guidance when daemon or direct capture is unavailable, while preventing unrecoverable daemon startup failures from causing reconnect loops. - Strengthened settings persistence, startup and shutdown cleanup, native input, capture, clipboard, and window lifetimes across desktop platforms. - Hardened Flatpak, AppImage, and other package validation so incomplete outputs, invalid staging inputs, and required setup failures are reported before publishing.

Required configuration

Requires: a screen with its shortest side at least 768 px. Recommends: keyboard, mouse or touchpad.

Additional information

Add-ons