Build useful Windows automations by snapping colorful blocks together—no programming required.
Download Macroblock Setup Wizard 0.1.0 for Windows
The installer is for 64-bit Windows 10 and 11. It is approximately 46 MB.
Macroblock is a visual automation app for Windows 10 and 11. You choose an action, place it on the canvas, change its options, and connect it to the next action. Macroblock then follows those blocks from top to bottom.
Everything runs locally on your computer. Macroblock does not upload your scripts, coordinates, typed text, or other automation data.
Macroblock can:
- Move, click, drag, and scroll the mouse—including previous, forward, and scroll-wheel buttons.
- Press, hold, release, and combine keyboard keys, or type complete text.
- Wait for a chosen amount of time and repeat a group of actions.
- Open files, folders, websites, and programs.
- Wait for a hotkey or a file to appear.
- Store simple values and make decisions with them.
- Run a PowerShell script when an advanced automation needs one.
- Download the Setup Wizard,
then open
Macroblock-Setup-0.1.0.exe. - Approve the Windows administrator prompt.
- Follow the Setup Wizard and keep Create a desktop icon selected if you want a shortcut.
- Select Launch Macroblock on the final page.
Macroblock always runs as administrator. This is required so its simulated
mouse and keyboard input works consistently with other elevated Windows apps.
Only open .mbk files and run PowerShell blocks that you trust.
If you are building the installer yourself, see Build from source.
- Select a category on the left, such as Mouse, Keyboard, or Timing.
- Drag a block onto the canvas. You can also double-click it or use the always-visible ADD BLOCK button.
- Change the values directly inside the block.
- Move blocks close together until the green snap preview appears, then release them to connect.
- Put actions inside a Repeat block by dropping them into its open middle.
- Select Run Script.
- Hold Esc for 0.5 seconds whenever you need to stop the automation.
Use Save to create a local .mbk file and Load to reopen it later.
| What you want to do | Control |
|---|---|
| Move a block or connected stack | Drag its DRAG handle |
| Add after the newest block | Use ADD BLOCK or double-click a palette block |
| Duplicate one block | Hold Left Alt and click the block |
| Duplicate several blocks | Select them, then right-click empty canvas space |
| Record a key or key combination | Click the red dot, press the keys, then release |
| Cancel key recording | Press Esc or click the red dot again |
| Move around a large canvas | Hold Space and left-drag |
| Zoom | Use the toolbar or hold Ctrl and scroll |
| Stop a running automation | Hold Esc for 0.5 seconds |
The numbered badges and blue connection arrows show the execution order. Blocks glow while moving, pulse when connected, and play a short wooden snap when they lock together.
| Category | Includes |
|---|---|
| Mouse | Move, click, drag, scroll, hold, and release |
| Keyboard | Press, type, combine, hold, and release |
| Timing | Fixed and random waits |
| Control | Repeat, repeat forever, conditions, and stop |
| Variables | Set, change, and delete saved values |
| Events | Start, hotkey, and file-wait triggers |
| System | Open a path or URL, launch a program, and run PowerShell |
Coordinates outside every connected monitor are safely skipped. Macroblock also refuses to run a script if its global Esc safety monitor cannot start.
- Windows asks for permission: choose Yes. Macroblock requires administrator access for reliable input automation.
- A block seems to be skipped: check its numbered badge and blue arrow. An unconnected block is a separate sequence.
- The mouse jumps too quickly: increase Move time on the movement block.
- A coordinate does nothing: use Show Cursor to confirm the point is on a connected monitor.
- A script will not stop: hold Esc, rather than tapping it, for at least half a second.
- Windows SmartScreen appears: locally built installers are not digitally signed. Only continue when the installer came from this repository or a source you trust.
This section is for developers and contributors. You need Windows 10 or 11, Git, an administrator account, and 64-bit Python 3.11 or newer.
git clone https://github.com/IamOumarIbrahim/macroblock-visual-automation.git
cd macroblock-visual-automation
py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\python.exe -m macroblockUsing the virtual environment's Python directly avoids PowerShell execution policy changes.
.\scripts\build.ps1This creates dist\Macroblock.exe. It is a single-file application with the
administrator requirement, icon, and wooden connection sound built in.
Install Inno Setup 6, then run:
.\scripts\build_installer.ps1The script builds the application first and then creates
dist\installer\Macroblock-Setup-<version>.exe. To reuse an existing
dist\Macroblock.exe, add -SkipAppBuild.
.\.venv\Scripts\python.exe -m pytestThe automated suite does not perform live clicks. The optional Windows
verification scripts in tests briefly take input focus and should only be
run when that is safe.
src/macroblock/blocks: block definitions and saved-script graphsrc/macroblock/ui: palette, block editors, canvas, and main windowsrc/macroblock/engine: script runner and Windows input simulationsrc/macroblock/overlay: click-through cursor crosshairsrc/macroblock/persistence: local.mbksave and loadinstaller: Inno Setup Wizard definitiondocs/ARCHITECTURE.md: technical design decisions
Contributions are welcome. Read CONTRIBUTING.md before opening a pull request. Use SUPPORT.md for help and SECURITY.md for security-sensitive reports. Everyone participating in the project must follow the Code of Conduct.
Macroblock is available under the MIT License.