en/enBoxer

en 936f123b18 Three routing modes: maps, mirror, off.

Mirror clones the real key to the other clients (passthrough still skipped).
Off leaves the front window alone except the mode-toggle hotkey.

2026-09-15 08:14:08 +02:00

2.9 KiB

Raw Blame History

enBoxer

Mapped-key routing and live window crops for World of Warcraft on Arch Linux + Hyprland. Rust.

You list which hotkeys go where. Everything you do not list stays on the focused primary. A passthrough list can leave movement keys alone (the example uses ESDF). Alt-tab off the team and the desktop is normal.

Nothing is loaded into the game. Hyprland delivers keys with hl.dsp.send_shortcut. You bind macros in WoW yourself.

Doc	What
PLAN.md	Product plan and how Grok / OpenCode split work
DESCRIPTION.md	One-page description
AGENT.md	Designer / PM / worker contract
TASKS.md	OpenCode tickets
CHANGELOG.md	What landed
docs/DESIGN.md	Routing model
docs/NOTES.md	WoW interact / Hyprland capture
docs/VIDEO.md	Live crop of another client
docs/MACROS.md	In-game macros

Routing (three modes)

Toggle with Shift+Alt+M (configurable) or enboxer mode maps|mirror|off while the daemon runs. A Hyprland notification shows the new mode.

maps — only keys you listed under maps are intercepted and sent where the map says. Everything else goes to the front window.
mirror — the front window still gets the real key; the same key is cloned to the other game windows. passthrough (e.g. ESDF) is not cloned.
off — nothing is intercepted. All keys go to the front window. The mode-toggle hotkey still works.

A map is a hotkey plus steps (send a key, send a named game_bind, wait) plus a target.

Interact / loot

WoW’s Interact with Target bind (plus Click to Move) walks an alt to the target and loots or talks. One press. Spamming it makes characters circle. The stock loot map: assist others → CTM on → interact once → wait walk_delay_ms → CTM off. See docs/MACROS.md.

Video FX

A region of another client is captured (grim) and shown on the primary. While the cursor is over that viewer, keys and clicks go to the source slot only. Covered sources need compositor toplevel export (not in this phase); keep the source visible for a live picture.

Optional Hyprland snippet: examples/hyprland.lua.

Build

cd ~/git/enBoxer
cargo build --release
install -Dm755 target/release/enboxer ~/.local/bin/enboxer

Needs Hyprland 0.56 (Lua dispatchers), hyprctl, grim, and mpv (Video FX overlay).

Use

mkdir -p ~/.config/enboxer
cp examples/profile.yaml ~/.config/enboxer/profile.yaml
# edit window_match, passthrough, maps, character names

enboxer doctor -c ~/.config/enboxer/profile.yaml
enboxer macros -c ~/.config/enboxer/profile.yaml
enboxer run   -c ~/.config/enboxer/profile.yaml

enboxer press Alt+G fires a map without a Hyprland bind (daemon must be running).

License

GPL-3.0-or-later.

2.9 KiB Raw Blame History Unescape Escape