MiniTask
Windows macro recorder

Record → Edit → Replay.

MiniTask is a Windows-only macro tool that records mouse and keyboard input and replays it with precise timing. It includes a graph-based editor, a macro library, hotkeys, and an optional always-on-top overlay.

Requirements: Windows 10/11
Raw mouse input (WM_INPUT) Low-level keyboard hook (WH_KEYBOARD_LL) Playback via SendInput JSON macro format Graph editor Tray + overlay
Security note: Macro tools can trigger antivirus or SmartScreen warnings.

Quick start

  • Press F8 to toggle recording. Use ■ Stop Recording to finish.
  • Press F9 to play/stop. Press F10 to pause/resume.
  • Use Ctrl+Shift+F12 for panic stop.
  • Save macros to the library (JSON), then load/search/rename/delete.
  • Open Edit to convert the macro into a node graph and adjust timing/data.

Functionality overview

  • Record mouse movement & clicks using Win32 Raw Input (captures high-resolution deltas and wheel events).
  • Record keyboard using a low-level keyboard hook (scan-code based recording).
  • Playback with accurate timing and speed control; loops and repeat counts supported.
  • Mouse playback modes: auto (detects “captured” mouse), force_relative, force_absolute.
  • Resolution/monitor adaptation: stores normalized positions to map clicks/moves to the current monitor.
  • Trim tool to remove leading/trailing time from a macro.
  • Macro library: search, load, save-as, overwrite, rename, delete (stored as JSON).
  • Graph editor: turn a macro into editable nodes (event type + delay + JSON data), then apply back to playback.
  • Tray icon + overlay: control from system tray and show a small status HUD on-screen.

How it works (from the code)

  • Input capture: registers Raw Input for the mouse and listens for WM_INPUT.
  • Keyboard capture: installs WH_KEYBOARD_LL and records scan codes + extended flags.
  • Hotkeys: uses RegisterHotKey for record/play/pause/panic/overlay toggles.
  • Playback: emits mouse/keyboard events through SendInput.
  • Storage format: macros serialize to JSON with timestamps and per-event data.
  • Editor model: builds a linear graph (Start → … → End) where each node contains delay + event payload.
The macro format is designed to be human-editable: delays are explicit, and event payloads are JSON objects.

Screenshots

The images below show the two primary areas: the Run tab (record/playback + library) and the Edit tab (graph-based macro editing).

MiniTask Run tab - transport, playback settings, macro library, and hotkeys
Run tab: transport controls (record/play/pause/panic), playback settings (loop, speed, mouse mode), trim tools, hotkeys, and a macro library for save/load/rename/delete.
MiniTask Edit tab - graph editor view of macro nodes
Edit tab: converts a macro into a node graph where each node is an event (mmove/mbtn/mwheel/key/text/comment/wait) with an explicit delay and editable JSON data.
Checksum:
SHA256(MiniTask.exe): 43d4ef89117c084b5790e331c42ac9c58250015721511c14d6f33942c28439a8

FAQ

  • Why does mouse mode have “auto”? Some games/apps capture and lock the cursor; relative moves work better in that case.
  • Where are macros stored? In a per-user macros folder as JSON files (shown in the UI).
  • Can I edit macros manually? Yes—macros are JSON; the graph editor also exposes per-node JSON data.
  • Is it cross-platform? No; it’s Windows-only by design (Win32 APIs).