A macOS app that turns your PS5 (or Xbox) controller into a rapid-fire keyboard macro trigger for World of Warcraft — designed for use with GSE (GnomeSequencer Enhanced).
Requires macOS 26 Tahoe (currently in beta). This app does not run on macOS 15 Sequoia or earlier.
GSE rotation macros advance their sequence on each keypress — which means you need to press the same key dozens of times per minute to keep your rotation going. Doing that manually is tiring, inconsistent, and hard on your hands.
With GSEController, you hold a trigger button and the app fires your macro key at a steady, configurable rate. Your rotation runs consistently without any hammering, and your keyboard hand stays free for cooldowns, targeting, and movement.
D-pad buttons add a second layer: hold one and it sends a modifier key (Alt/Shift/Ctrl) to WoW, which activates a conditional branch in your GSE sequence — letting you inject an interrupt, a defensive, or a proc ability mid-rotation without breaking the loop.
Profile editor showing a Guardian Druid setup — R1 on Rapid at 10x/s, D-pad modifier bindings shown in the controller map.
- Multiple profiles — one per class/spec, switch from the toolbar
- Per-button configuration — assign any controller button to any key, with any fire mode
- Three fire modes:
- Rapid — spams the key while held (for GSE rotation macros)
- Tap — fires once per press (for manual cooldowns)
- Modifier — holds Alt/Shift/Ctrl while pressed (activates conditional branches in your GSE sequence)
- Configurable rate — 6/10/15/20 presses per second, or custom
- Controller map — visual overview of all your bindings at a glance
- WoW focus guard — optionally only fires when WoW is the active window
- Profile templates — pre-built starting points for common specs and roles
- macOS 26 Tahoe beta (does not run on macOS 15 Sequoia or earlier)
- Xcode 26 beta with command-line tools (required to build)
- A PS5 DualSense or Xbox controller connected via USB or Bluetooth
- Accessibility permission (to send key events to WoW)
- World of Warcraft (Retail or Classic) with GSE installed
No pre-built binary is available. The app is unsandboxed and can't be signed for general distribution, so you must build from source. Xcode 26 beta and macOS 26 beta are required.
git clone https://github.com/jcll/GSEController.git
cd GSEController
./install.shinstall.sh builds a Release binary and copies it to /Applications/GSEController.app.
On first launch, macOS will ask for Accessibility permission — this is required for the app to send keystrokes to WoW.
- Launch GSEController and connect your controller
- Click + and pick a profile template for your role, or start blank
- For each binding, set the button, fire mode, and key to match your GSE macro keybind
- Set the fire rate — 10 pps (100 ms) is a safe default for most GSE sequences. If your GSE macro has a custom
mssetting, match the rate:pps = 1000 ÷ ms - Click Save, then click Start
- Create or import a GSE macro for your spec (Wago.io has many ready-to-use sequences)
- Drag the macro to an action bar slot
- Keybind that slot to the same key you configured in GSEController
- Test the keybind manually in WoW before relying on GSEController
All templates default to key K — change it to match your actual GSE keybind after selecting.
| Template | R1 | R2 | D↓ (Alt) | D← (Shift) | D→ (Ctrl) |
|---|---|---|---|---|---|
| Guardian Druid | Rapid 10pps | Rapid 10pps | Frenzied Regen | Incapacitating Roar | Rebirth |
| Generic Tank | Rapid 10pps | Rapid 10pps | Defensive CD | CC / Utility | Taunt / Off-GCD |
| Melee DPS | Rapid 10pps | Rapid 10pps | Defensive CD | Interrupt | Major DPS CD |
| Ranged / Caster | Rapid 10pps | Rapid 12pps | Defensive CD | Interrupt / Kick | Major DPS CD |
| Healer | Rapid 10pps | — | Major CD | Dispel / Utility | Raid CD |
| Simple — R1 Only | Rapid 10pps | — | — | — | — |
D-pad buttons use Modifier Hold mode in all templates — holding the button sends that modifier key to WoW. Any button can use any fire mode; D-pad for modifiers is just a convention.
If you use ConsolePort alongside this app:
- Unbind the trigger button in ConsolePort so it doesn't double-fire
- Or use L3/R3 as your trigger — ConsolePort rarely binds those by default
- D-pad directions used for Modifier mode will also fire as native WoW gamepad inputs — unbind them in ConsolePort, or accept the double-fire
- If you run ConsolePort's Enhanced Gamepad mode, it may intercept all controller input before GSEController sees it. You'll need to disable Enhanced Gamepad mode or assign non-overlapping buttons to each app
GSEController requires you to physically hold a button to fire — it does not play the game for you. It sends keypresses at a fixed rate on your behalf, which is functionally similar to keyboard hardware key repeat. GSE itself is an approved addon.
That said, Blizzard's policies can change and this app is not officially endorsed. Use it at your own discretion.
The app uses Apple's GameController framework to read controller input. Key events are sent via a small helper binary (KeyHelper) that is compiled from source at runtime — this allows it to hold the Accessibility permission separately from the main app process.
When no controller is connected, the helper stays running in the background but is dormant — it only forwards key events when the main app sends them, which only happens in response to button input.
GSEController has an unusual architecture that security-conscious users should understand before installing:
-
No sandbox: The app runs without the macOS app sandbox. This is required to compile and launch the KeyHelper binary at runtime. It means the app has unrestricted filesystem and process access under your user account.
-
Runtime C compilation: On first launch, the app compiles a small C program (
KeyHelper) using/usr/bin/ccand stores the binary at~/Library/Application Support/GSEController/keyhelper. The source is embedded inKeySimulator.swift— you can audit it before building. -
Persistent launchd agent: The helper is registered as a launchd user agent (
com.jcll.GSEController.helper) that starts at login and stays running in the background. It receives key events from the main app via a FIFO and posts them viaCGEventPost. When no controller is connected and the main app is not running, it is dormant. -
Accessibility permission: The helper binary (not the main app) holds the Accessibility permission used to send keystrokes. This is standard practice for apps that need to send events to other applications.
If you have concerns about any of this, you can review the full source at github.com/jcll/GSEController before building.
To fully remove GSEController:
# Unload and remove the launchd agent
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.jcll.GSEController.helper.plist
rm ~/Library/LaunchAgents/com.jcll.GSEController.helper.plist
# Remove the app and support files
rm -rf /Applications/GSEController.app
rm -rf ~/Library/Application\ Support/GSEController
rm -rf ~/Library/Logs/GSEControllerxcodebuild -project GSEController.xcodeproj -scheme GSEController -destination 'platform=macOS' buildxcodebuild test -project GSEController.xcodeproj -scheme GSEController -destination 'platform=macOS,arch=arm64'98 unit tests across 5 test suites covering Models, ControllerManager, FireEngine, KeySimulator, and DualSenseBatteryMonitor. No mocking infrastructure — tests run entirely in-process via TEST_HOST/BUNDLE_LOADER.
MIT — see LICENSE
See CHANGELOG.md for version history.