OmniMacro

A powerful, feature-rich automation tool for Windows (win64 only, sorry ARM people).

---

Overview

OmniMacro is a comprehensive Windows automation utility designed for power users and those who want to save effort and time on daily tasks. It combines multiple automation features into a single convenient executable with an intuitive interface and a modern, sleek theme.

⚠️ Important: If certain features don't work as intended, run as administrator for full functionality.

---

Features

Human Typer

A sophisticated typing simulator that mimics human behavior:

Feature	Description
Speed Range	Variable WPM (10-200) for realistic variation
Typo Simulation	Adjacent keys or random letters with auto-correction
Synonym Swap	Types synonym first, then corrects to intended word
Correction Delay	Configurable pause before fixing typos (20-1000ms)
Multi-Typos	Simulate multiple consecutive errors (smart limit based on word position)
Thinking Pauses	Random pauses between words (0-50% frequency)
Sentence Pauses	Pauses after .!? with configurable frequency
Paragraph Pauses	Pauses after newlines with configurable frequency
Special Char Delay	Pauses 500-1500ms before typing symbols (simulates looking for keys)
Emotion Simulator	Crashout (rage spam), Nihilism (existential phrases), Vamp (Carti lyrics) - triggers after 20%, won't happen back-to-back
Auto-Pause on Click	Typing pauses if mouse clicked (prevents wrong location typing)
Resume	Continue typing from exact position with 3-second countdown

Synonym Dictionary: Built-in dictionary with 200+ common words including verbs, adjectives, nouns, and adverbs.

Recoil Control

• Vertical & Horizontal compensation with adjustable strength
• LMB Only or LMB + RMB activation modes
• Fine-tuning with decimal precision (0.1 increments)
• Save/Load configuration profiles
• Hotkey: F4

Keyboard Macro

• Bind any key for rapid-fire repeating
• Adjustable delay between key presses
• Hotkey: F5

Auto Clicker

• Adjustable click interval (1-1000ms)
• Hotkey: F6

Anti-AFK

• Random direction cursor movement with return
• Variable speed to avoid detection
• Adjustable magnitude and interval
• Hotkey: F7

Camera Spin

• Continuous horizontal cursor movement
• Left/Right direction selection
• Adjustable speed (pixels per tick)
• Hotkey: F8

Custom Macros

• Unlimited custom macro slots
• Bind keyboard keys or mouse buttons as triggers
• Multi-key actions - press multiple keys simultaneously
• Hold-to-repeat functionality
• Persistent storage - macros saved across sessions

---

Tech Stack

Component	Technology
Language	Python 3.12+
GUI Framework	Flet (Flutter-based)
Input Handling	pynput
Packaging	PyInstaller
OS Integration	Windows API (ctypes)

---

Installation

Option 1: Download Release (see I actually package into .exe because I'm nice, unlike some people...)

• Download the latest OmniMacro.zip from the Releases page.
• Unzip the .zip file to any location on your computer. Ensure both the OmniMacro.exe and the configs folder are in the same folder. Run the .exe (preferably as administrator).

Option 2: Build from Source

# Clone the repository
git clone https://github.com/Entropify/OmniMacro.git
cd OmniMacro

# Create virtual environment
python -m venv venv
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run directly
python main.py

# Or build executable
pyinstaller OmniMacro.spec --noconfirm

---

Project Structure

OmniMacro/
├── main.py           # GUI application and UI logic
├── macro_core.py     # Core automation engine
├── input_utils.py    # Low-level Windows input utilities
├── OmniMacro.spec    # PyInstaller build configuration
├── requirements.txt  # Python dependencies
├── assets/
│   └── icon.ico      # Application icon
└── dist/
    └── OmniMacro.exe # Compiled executable

---

Usage

1. Launch OmniMacro.exe as Administrator
2. Navigate using the sidebar tabs
3. Configure your desired features
4. Activate using toggle switches or hotkeys
5. Save your settings for future sessions

Hotkey Reference

Key	Function
F4	Toggle Recoil Control
F5	Toggle Keyboard Macro
F6	Toggle Auto Clicker
F7	Toggle Anti-AFK
F8	Toggle Camera Spin

---

Screenshots

The application features a modern dark theme with:

• Clean navigation rail
• Intuitive sliders and toggles
• Real-time setting updates
• Smooth animations

---

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright 2024 Entropify

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

---

Credits & Acknowledgments

• Final-Typer by Peteryhs - Inspiration for the Human Typer feature
• Flet - Modern Python UI framework
• pynput - Cross-platform input control

---

Disclaimer

This software is provided for educational and personal use only. The author is not responsible for any misuse of this tool. Use responsibly and in accordance with the terms of service of any applications or games you interact with.

---

Made with ❤️ by Entropify