Home / MacroHok v2.2
Name Modified Size InfoDownloads / Week
Parent folder
MacroHok.exe 2025-10-06 13.0 MB
readme.txt 2025-10-06 4.1 kB
Totals: 2 Items   13.0 MB 2
Got it ✅ — here’s the **updated `README.txt`** rewritten for **MacroHok v2.2** (matching your current app features and behavior in `main.py`).

# 🎯 MacroHok v2.2

**Developed by Hoku**

A smart and modern macro automation tool for **Windows** that records and plays back mouse clicks, keyboard inputs, and scrolls — now with drag-and-drop reordering, preset management, and built-in performance stats.
Perfect for **Roblox automation**, productivity tasks, or repetitive workflows.

====================
🆕 What’s New in v2.2
=====================

🖱️ **Drag-and-Drop Actions**
Reorder your actions directly in the table with simple mouse dragging.

💾 **Preset Manager**
Save and load macros using preset names from a dropdown.
Popups are now centered, non-resizable, and auto-close after success.

📁 **Open Preset Folder**
Quickly open the preset directory to share or manually edit your macro files.

📊 **Performance Stats**
After each run, see total runtime, number of actions, and average time per action.

🚀 **UI Enhancements**
• Startup window is centered and not always on top.
• “Show Log” and “Human Mode” are off by default.
• Removed “Ignore Delay” option for cleaner timing.
• All dialogs are unified in style and placement.

🧭 *Coming Soon:* Human Randomness Slider — to add natural human-like variations.

====================
🛠️ Features
============

✅ **Save / Load Macros (JSON)**
Create, reuse, and share macro scripts easily.

✅ **Target Window Selection & Refresh**
Choose your app (e.g., Roblox) and refresh to see active windows.

✅ **Reorder, Edit, Duplicate, Delete**
Right-click any action or drag to change order instantly.

✅ **Run All / Run Selected**
Execute either all actions or just one at a time.

✅ **Infinite Loop Mode**
Keep repeating until stopped manually.

✅ **Per-Action Delay, Repetition & Hold Time**
Customize how each step behaves.

✅ **Human Mode**
Simulates natural movements and click behavior.

✅ **Floating Log Window**
Displays recent actions, countdowns, and performance summary.

✅ **Preset Manager & Folder Access**
Save macros as presets, or open your preset folder to share files.

✅ **Performance Tracker**
Automatically logs total execution time and actions-per-second.

====================
🎹 Hotkeys
==========

🖱️ ALT + X → Record a mouse click
🎹 ALT + K → Record a key press
🌀 ALT + S → Record a scroll action
⛔ ALT + Q → Stop a running loop

====================
💻 How to Use
=============

1. **Run MacroHok**
   Double-click `MacroHok.exe` (after extracting the ZIP).

2. **Select a Target Window**
   Pick your app from the dropdown, or click “Refresh Windows” if not listed.

3. **Record Actions**

   * ALT + X → Record a click
   * ALT + K → Record a key press
   * ALT + S → Record a scroll action

4. **Edit, Reorder, and Manage**

   * Right-click to edit, delete, or duplicate.
   * Drag actions to reorder them visually.

5. **Save or Load Presets**

   * Use “Save Preset” or “Load Preset” buttons.
   * Click “Open Preset Folder” to access your preset files.

6. **Run or Stop**

   * Click “Run Script” to start.
   * Press ALT + Q to stop any running loop.

7. **Monitor Logs & Stats**

   * Check “Show Log” to view progress.
   * See performance stats after each full run.

8. **Optional Settings**

   * “Infinite Loop” → repeat indefinitely.
   * “Human Mode” → mimic real user movement.

====================
⚠️ Disclaimer
=============

MacroHok is for **personal and educational use only**.
The developer is **not responsible** for misuse, bans, or any data loss.
Always follow the terms of service of the apps or games you automate.

====================
🙏 Credits
==========

Made with ❤️ by **Hoku**
Thanks for using **MacroHok v2.2**!
Feedback and feature suggestions are always welcome.
Source: readme.txt, updated 2025-10-06