Repio Documentation

Macro Recorder, Editor & Player — v5.0.x (PRO Edition)
Single-file Python/tkinter application

#Community Edition FREE

Community Edition (v3.3) is a free, open-source single-file Python application available on GitHub. It provides core macro recording and playback functionality.

• Mouse & keyboard recording — clicks, movement, scroll, keydown/keyup
• Precise playback engine — lazy generator with virtual clock
• CSV editor with loops — TreeView table, loop_start/loop_end pairs
• Include files — local CSV includes with LRU cache (32 entries)
• Undo / Redo — 50-state history with deep copy
• Breakpoints (F9) — toggle, red highlight, auto-stop during playback
• Bookmarks (Ctrl+B) — toggle, cyan highlight, navigate with wrap-around
• Search in comments (Ctrl+F / F3) — case-insensitive, cyclic
• Open source (Python) — single repio-dev-comm.py file, MIT-friendly

Features available in PRO only: Web Hooks (HTTP URL includes), Save As, Unsaved changes tracking, Settings dialog, Column management, Cumulative timeline, Post-script actions, Configurable hotkeys, Build versioning, Run external program, Window persistence, Launch on login.

⬇ Download Community Edition from GitHub • Compare editions

#1.1 Recording

Records all user actions in real-time:

• Mouse movement — coordinates (x, y) with high-precision timestamps (time.perf_counter())
• Mouse clicks — separate mousedown/mouseup, buttons: left, right, middle
• Scroll wheel — scroll with delta (dx, dy) and coordinates
• Keyboard — separate keydown/keyup for each key (including Shift, Ctrl, Alt, function keys, etc.)
• Auto pause insertion — pause with precise delay_ms between events
• Move collapse — consecutive move events merged into one (noise reduction)
• Start/End markers — auto-inserted comments --- Start Rec [N] ---
• Record from position — insert recording after selected row
• Filter hotkeys — F6 (stop) filtered from recording

Hotkey: F5 (toggle — start/stop recording)

#1.2 Playback

Lazy playback engine with memory optimization:

• Generator engine — lazy_action_iterator() uses Python generators and yield from for recursive loop/include expansion. Memory: O(depth) instead of O(total_actions)
• Virtual clock — precise timing via time.perf_counter() with virtual accumulator. Sleep granularity: 10ms
• Position context — generator returns (action, context) with file, line, loop stack info
• Status bar — updates every 5 actions with current action number, file, loop iterations
• Cleanup on stop — all held keys and mouse buttons automatically released
• Duration display — shows expected duration before start

Hotkeys: F8 Play • F6 Stop • Esc Stop

#1.3 Pause / Resume

• F7 — toggle pause/resume
• Pause button in toolbar changes appearance (sunken + orange background)
• Generator state preserved in memory — resumes from exact position
• Play button always shows ▶ (never changes to "Continue")

#1.4 Breakpoints Community

• F9 or context menu to toggle
• Red highlight (IndianRed #CD5C5C) with white text
• Player auto-stops at breakpoint lines
• Continue with F7 or F8
• Stored in CSV as is_breakpoint field

#1.5 Bookmarks Community

• Ctrl+B or context menu to toggle
• Cyan highlight (#E0FFFF)
• Navigate with toolbar buttons with wrap-around
• Stored in CSV as is_bookmark field

#1.6 Loops

• Select rows → Insert > Loop → enter repeat count
• Structure: loop_start (with loop_count) and loop_end pair
• Nested loops supported with correct level matching
• Lazy expansion during playback (no memory copies)
• Status display: "Loop 3/10 > 2/5" for nested loops

#1.7 Include Files

• Insert > Include File → choose local CSV or HTTP URL (HTTP/URL includes — PRO only)
• Recursive inline playback via generator
• Duration annotation auto-calculated in comment (PRO only)
• LRU cache (32 entries) with mtime check for files, TTL 60s for URLs
• Max depth: 20 levels (circular include protection)
• Status shows: [filename.csv:15] — current file and line

#1.8 Editing

TreeView table with 10 columns: #, Type, X, Y, Btn, Key, Delay, Loops, File, Comment

• Double-click or Enter opens EditDialog
• EditDialog: modal window with fields for all action properties, "Record Key" button for live key capture
• Move rows with ⬆/⬇ toolbar buttons
• Multi-select: Shift+Click, Ctrl+Click
• Page Up/Page Down — move selection by 15 rows
• Ctrl+Up/Ctrl+Down — move selected rows up/down
• Shift+Up/Shift+Down — extend selection (standard behavior)

#1.8b Column Management PRO

• View > Column Settings — reorder columns, toggle visibility
• Timeline column — cumulative duration (running total) left of row number
• Delay column displays in short format: 5.4s, 1m 5.0s
• Column order and visibility persisted in settings.json

#1.8c Settings PRO

• Tools > Settings — opens 4-tab dialog
• Recording: min mouse movement filter (pixels), ignore multiple modifier keys
• Playback: pause on real mouse movement, pause on keyboard, post-script action
• Hotkeys: reconfigure Start/Stop/Play/Pause keys
• General: launch on login, start minimized, auto-open last file

#1.8d Run External Program PRO

• Insert > Run Program — select executable and arguments
• Creates run_program action type
• During playback: launches the program via subprocess.Popen

#1.8e Post-Script Actions PRO

• After script completes: None, Lock, Logout, Restart, Shutdown
• Configurable in Settings > Playback tab
• Windows-only: uses ctypes and shutdown commands

#1.9 Clipboard & History

• Ctrl+C/Ctrl+X/Ctrl+V — Copy/Cut/Paste with deep copy
• Ctrl+Z/Ctrl+Y — Undo/Redo (50 states max)
• Ctrl+A — Select All

#1.10 Search Community

• F3 / Ctrl+F — search in comment fields
• Case-insensitive, cyclic (wraps around)
• Remembers last query

#1.11 File Operations

CSV format with 13 header fields, UTF-8 encoding.

• Ctrl+N New • Ctrl+O Open • Ctrl+S Save • Ctrl+Shift+S Save As
• Recent Files submenu (up to 10 files)
• Auto-open last file on startup
• Unsaved changes tracking: asterisk (*) in title, confirmation dialog on close

#1.12 Versioning PRO

• Base version: APP_VERSION_BASE = "4.0"
• Build index: auto-increment on each run, stored in build_index.json
• Full version: 4.0.N displayed in window title and About dialog

#1.14 Web Hooks PRO

Include macro actions from a remote server via HTTP/HTTPS.

• URL in file_path field of include action
• GET request with query params: ?filename=...&ip=...&line=...
• Timeout: 3 seconds • User-Agent: Repio/{version}
• Response: CSV with compatible headers (13 fields)
• Cache: TTL 60 seconds for URL responses
• Preview Hook: context menu to preview URL content in separate window

#Hotkeys Reference

#CSV Format

UTF-8 encoding, comma delimiter, first row is headers. 13 fields:

#Action Types

#Architecture

Threading Model

Main Thread (UI)          ← tkinter mainloop
  _process_queue()          root.after(10ms) polling
  refresh_table()
  all UI callbacks

pynput listeners          ← Background daemon threads
  mouse.Listener             Write events to queue.Queue
  keyboard.Listener

Playback Thread           ← threading.Thread (daemon)
  player.play()              Reads from generator
  virtual clock

Key Classes

#Constants

#Dependencies

python >= 3.7
tkinter, csv, time, threading, queue, copy,
os, json, io, webbrowser, urllib.request,
urllib.parse, urllib.error, socket          # all stdlib

pynput                                     # pip install pynput (only external dep)