Origin

A general-purpose keyboard & mouse macro automation tool for Windows.

Design bindings, build action sequences, record live input, and play it all back on a hotkey — with groups, speed control, a panic switch, and a clean modern UI.

---

Features

• Hotkey-bound macros — bind any key (or a Ctrl+Shift+Alt+Win combo) to fire a sequence of actions. Left/right of a modifier family both satisfy the combo.
• Action sequences — keystrokes (press/release pairs), key holds (press → hold N ms → release), delays (fixed or randomized), and mouse-wheel scrolls, in any order. Drag to reorder, undo/redo edits.
• Record mode — capture your live keyboard/mouse input straight into a fresh macro, with leading dead-air trimmed and trackpad-scroll bursts coalesced.
• Macro groups / profiles — keep a Work set and a Gaming set in one file; only the active group's macros are shown and fire. Switch from the group selector, the tray menu, or the right-click Move to group submenu.
• Speed control — a global speed slider (10%–500%) plus a per-macro multiplier (0.1×–5×). They multiply, so 200% global × 2× per-macro = 4× faster playback.
• Panic key — one configurable hotkey (default `) aborts every running macro and releases any stuck keys. Works even while recording or binding.
• Stop a single macro — halt just the selected macro without touching others.
• Per-macro enable/disable, cooldown, rename, duplicate, and unbind.
• Binding-conflict detection — two enabled macros in the same group sharing a trigger are flagged (⚠) so a single press doesn't silently fire both.
• Suspend all triggers — pause every macro trigger globally (panic still works).
• Import / Export macros as .json files.
• 8 accent-tinted themes with line icons that re-tint on theme switch.
• Portable — macros and settings live next to the executable, so you can carry the folder on a USB stick. High-DPI aware. Runs from the system tray.

📖 Full walkthrough: see USERMANUAL.md.

Quick start (no build required)

1. Go to the latest Release and download Origin.exe.
2. Put it in its own folder (e.g. C:\Tools\Origin\).
3. Run it. Your macros and settings are saved as origin_macros.json and origin_settings.json right next to the exe — back those up to keep them.

That's it — no installer, no Python needed.

Run from source

pip install -r requirements.txt
python "Source Code.py"

Requirements: Windows 10/11, Python 3.8+, PyQt5, pynput (see requirements.txt).

Build the distributable

pip install -r requirements.txt
pyinstaller --noconfirm --workpath .pyi_build --distpath dist Origin.spec

This produces a single windowed dist/Origin.exe. See BUILD.md for the full build & development guide.

Project layout

Origin/
  Source Code.py        # entry point (PyInstaller target)
  Origin.spec           # PyInstaller spec (onefile, windowed)
  origin.ico            # app icon (window, tray, exe)
  origin/               # the application package
    config.py           # paths, version, resource resolution
    model.py            # macro/action model + the single key/button naming layer
    storage.py          # atomic save, corrupt-file backup, migration, settings
    runner.py           # macro execution with abort + panic release
    triggers.py         # global hotkey detection (pause/suspend, panic key)
    recorder.py         # live input recording
    dialogs.py           # bind capture + themed input dialog
    ui.py               # accent-palette themes + animation helper
    icons.py            # accent-tinted SVG line icons
    app.py              # OriginApp main window
  legacy/               # the original v3 source, kept for posterity
  tests/                # logic + headless GUI smoke tests
  BUILD.md              # build & dev guide + changelog + JSON schema
  USERMANUAL.md         # end-user manual

Safety & responsible use

Origin is a general-purpose automation and accessibility tool. It simulates keyboard and mouse input on your own machine. Please use it for your own workflows, games, and accessibility needs, and respect the terms of any software you automate. See the license for the full no-warranty terms.

License

MIT — © 2026 Thoria Development.