universe controller
Controller macros: paddles and spare buttons bound to actions
Usage: universe controller [OPTIONS] <COMMAND>universe controller ls
Section titled “universe controller ls”Connected pads with their buttons, then the macros and presets
Usage: universe controller ls [OPTIONS]universe controller watch
Section titled “universe controller watch”Run the macro engine (the launcher and a game’s unit start it themselves)
Usage: universe controller watch [OPTIONS]Options
Section titled “Options”--json: One JSON object per line on stdout, commands on stdin.--wait: Wait for the running watcher to end instead of exiting at once.
universe controller bind
Section titled “universe controller bind”Bind an action to a button
Usage: universe controller bind [OPTIONS] <FAMILY> <BUTTON> <TRIGGER> <ACTION>Arguments
Section titled “Arguments”<FAMILY>: Family: dualsense-edge, xbox-elite, … or*for every pad.<BUTTON>: Button: paddle_left, fn_right, guide, ….<TRIGGER>: press or hold. One ofpress,hold.<ACTION>: volume_up, volume_down, mute, screenshot, mangohud, stop, keys, command.
Options
Section titled “Options”--keys <KEYS>: Forkeys: the combo, e.g. Super_L+F12.--command <COMMAND>: Forcommand: run with sh -c.
universe controller unbind
Section titled “universe controller unbind”Remove a button’s macro (both triggers when none is given)
Usage: universe controller unbind [OPTIONS] <FAMILY> <BUTTON> [TRIGGER]Arguments
Section titled “Arguments”<FAMILY><BUTTON>[TRIGGER]: One ofpress,hold.
universe controller learn
Section titled “universe controller learn”Press a button on the pad: its code becomes the slot’s
Usage: universe controller learn [OPTIONS] <FAMILY> <SLOT>Arguments
Section titled “Arguments”<FAMILY><SLOT>: The slot the pressed button will drive.
universe controller forget
Section titled “universe controller forget”Forget a learned button (the shipped codes apply again)
Usage: universe controller forget [OPTIONS] <FAMILY> <SLOT>Arguments
Section titled “Arguments”<FAMILY><SLOT>
universe controller dump
Section titled “universe controller dump”A pad as tests/pads records it: ids, keys, axis ranges, driver, HID report descriptor and what the modules see (SDL3’s view)
Usage: universe controller dump [OPTIONS] [ID]Arguments
Section titled “Arguments”[ID]: A pad’s id fromcontroller ls; every pad when none.
Options
Section titled “Options”--walk: Ask for each button, stick and trigger in turn and record what the pad reports for it.
universe controller reconnect
Section titled “universe controller reconnect”Drop a Bluetooth pad’s link and bring it back, then tell the running game’s modules (a cable’s pad has to be re-plugged)
Usage: universe controller reconnect [OPTIONS] [ID]Arguments
Section titled “Arguments”[ID]: A pad’s id fromcontroller ls, orall. Defaultall.