Skip to content

README.md

Latest commit

 

History

History
91 lines (72 loc) · 2.94 KB

README.md

File metadata and controls

91 lines (72 loc) · 2.94 KB

PyMacroRecorder

License Top Language Python Version Size Contributors Last Commit Issues Pull Requests

Forks Stars Watchers

Latest Release Release Date Build Status Codacy Badge

Tkinter app to record, play, and save keyboard/mouse macros.

Features

  • Global recording (pynput) with live log.
  • Buttons: Start/Stop Record, Start/Stop Macro, Save Macro, Load Macro.
  • Configurable global hotkeys (minimum 2 keys). Control combos are ignored during recording.
  • Save/load macros as CSV (name + events JSON). The displayed preview is what is replayed.
  • Playback with repeat count (0 = infinite) and immediate stop.

Structure

PyMacroRecorder/
├─ main.py
├─ requirements.txt
├─ pyproject.toml
├─ README.md
├─ LICENSE
├─ CONTRIBUTING.md
├─ build.ps1
├─ build.sh
├─ .gitignore
├─ .github/
│  └─ workflows/
│     ├─ ci.yml 
│     └─ release.yml
└─ pymacrorecorder/
   ├─ __init__.py
   ├─ app.py
   ├─ config.py
   ├─ hotkeys.py
   ├─ models.py
   ├─ player.py
   ├─ recorder.py
   ├─ storage.py
   └─ utils.py

Quick start

python -m venv .venv
source .venv/bin/activate  # Windows: `.venv\Scripts\activate`
pip install -r requirements.txt
python main.py

Save & config

  • Macros: CSV chosen via the UI (columns name, events).
  • Hotkeys: config.json in the user data directory (see pymacrorecorder/config.py).

Default hotkeys

  • Start Record: Ctrl+Alt+R
  • Stop Record: Ctrl+Alt+S
  • Start Macro: Ctrl+Alt+P
  • Stop Macro: Ctrl+Alt+O
  • Save Macro: Ctrl+Alt+E
  • Load Macro: Ctrl+Alt+L

Click a hotkey label in the UI, press a new combination (≥2 keys) to save it.