v0.2.0-alpha.1 - Rule sets, template capture, and usability improvements

v0.2.0-alpha.1

This is an experimental alpha release of Macro Tool.

This release focuses on improving day-to-day usability around rule management, rule set switching, template image creation, and detection feedback.

Highlights

• Added rule set switching from rules/*.json
• Added rule set creation from the GUI
• Added rule duplication
• Added rule reordering with Up/Down buttons
• Added drag-and-drop rule reordering
• Added detection image preview in the main window
• Added template image capture from screenshots
• Added click-free Test Detection score display
• Added latest status and score display in the rule list
• Added Esc key stop while the Macro Tool window is focused
• Improved support for rules.json and rules/*.json shown together
• Updated README screenshots

Rule Sets

Rule sets can now be managed as JSON files.

• rules.json is shown as rules
• rules/tower.json is shown as tower
• rules/rules.json is shown as rules (1)

The GUI can create a new empty rule set under the rules directory using the New button.

Deleting and renaming rule sets are intentionally not provided in the GUI. Users can manage those JSON files directly if needed.

Template Capture

The Rule Editor now includes a Capture button for detection images.

You can select an area from the current screenshot and save it as a PNG template image, then use it directly as the rule's detection image.

Detection Feedback

Test Detection and runtime feedback are easier to inspect.

• Test Detection shows best match scores even below the confidence threshold
• The selected rule summary shows the latest test result
• The rule list shows latest status and score, such as matched, below threshold, clicked, cooldown, not matched, or error

Safety / Operation

• Press Esc to stop while the Macro Tool window is focused
• Existing Start/Stop behavior remains unchanged
• Rule editing and rule set switching are disabled while running

Validation

Verified locally:

python -m pytest

v0.1.0-alpha.2

Notes

• This is an experimental alpha build for prototype/demo use.
• Windows Defender or SmartScreen may warn because the executable is unsigned.
• Do not run rule files from untrusted sources.
• The app now warns before starting if an enabled rule's search region overlaps the Macro Tool window.
• Packaged builds store rules.json next to the executable.

v0.1.0

Macro Tool v0.1.0

First stable prototype release.

Macro Tool is an image-recognition desktop macro tool that detects configured template images inside selected screen regions and executes click actions.

Features

• Image-recognition based click rules
• PySide6 desktop GUI
• Rule add/edit/delete
• Search region selector
• Click position selector on template images
• Transparent PNG mask support
• Mask editor with Mask/Restore tools
• Ctrl+Z undo in Mask Editor
• JSON rule storage
• Cooldown-based repeated click prevention
• Test Detection without clicking
• Runtime logs
• Multi-monitor region support
• Japanese filename support for template images
• Windows packaged build via PyInstaller

Improvements Since Alpha

• Improved rule editor validation
• Added warnings for rules that overlap the Macro Tool window
• Improved rule list enable/disable behavior
• Updated README screenshots and documentation
• Added v0.1.0 release checklist and known limitations

Notes

• This release is Windows-focused.
• The executable is unsigned, so Windows Defender or SmartScreen may warn.
• Do not run rule files from untrusted sources.
• Some applications may ignore simulated mouse input or handle it differently from normal clicks.
• Rule data is stored in rules.json next to the executable when using the packaged build.

v0.1.0-alpha.1

Macro Tool v0.1.0-alpha.1

First alpha prototype release.

Features

• Image-recognition based click rules
• PySide6 GUI
• Rule add/edit/delete
• Region selector
• JSON rule storage
• OpenCV template matching
• PyAutoGUI screenshot and click execution
• Windows PyInstaller build

Notes

This is an experimental alpha build for prototype/demo use.
Windows Defender or SmartScreen may warn because the executable is unsigned.