A native Qt 6/QML app, backed by Rust through CXX-Qt, for visually creating and running macros on Windows, Linux, and macOS.
Working on the code? CONTRIBUTING.md covers the layout, tests, and how to add a block or reporter.
git clone https://github.com/Blockworked/blockwork.git Blockwork && cd Blockwork
justCargo fetches the Lucide icons (lucide-qt) from its tagged release. The Blockstitch core and native QML frontend
are fetched from the same pinned Git revision, so their APIs stay in sync.
The desktop build fetches a pinned, checksum-verified QWindowKit archive into its
build cache and compiles it automatically. It
requires CMake 3.19+, a C++17 compiler, and a full Qt 6.10+ SDK with its CMake files
and private development headers. Set QMAKE to that SDK's qmake if multiple Qt
installations are present. The first build needs network access; offline builds
can supply QWindowKit through BLOCKWORK_QWINDOWKIT_SOURCE_DIR. Release packaging uses
windeployqt/macdeployqt to include the dynamic Qt runtime.
AUR: blockwork
just installThis builds before installing. On Windows it builds, signs, and installs a local
MSIX package (certificate installation requires elevation); on macOS it installs
the app bundle into /Applications.
To build and launch from the checkout, use just run. On Windows this stages the
editor, daemon, and Qt runtime in dist/windows-local before launching.
Release builds of the Windows installer are published automatically on each GitHub release. To build one locally:
- Install Inno Setup 6 (one-time).
- Run:
This produces
pwsh -File scripts/build-installer.ps1
dist\blockwork-windows-x86_64-setup.exe.
Recording input and playing back macros uses /dev/uinput and /dev/input/event*
directly, so your user needs to be in the input group:
sudo usermod -aG input $USERLog out and back in (or reboot) for the new group membership to take effect.