Skip to main content

HID Mode (Keyboard & Mouse)

In HID Mode the FrenschPress enumerates on the computer as a USB keyboard and mouse instead of a MIDI device. Every button and every encoder movement then sends a keystroke or a mouse action.

Typical use: a redundant PowerPoint or Keynote control that needs no extra software and no MIDI routing.

HID Mode switch in Settings

Enabling​

The switch is in Settings under HID Mode.

  1. Turn on Enable HID Mode.
  2. Press Save & Reboot. The FrenschPress restarts and enumerates in the new USB role.

To switch it off, turn off Enable HID Mode in the same place and press Save & Reboot again.

HID Mode disables USB MIDI and macros

While HID Mode is active, the FrenschPress sends no USB MIDI and runs no macros. The buttons trigger only the keyboard and mouse actions set up below. Companion Mode is inactive during that time as well.


Mappings​

With HID Mode active, the HID Key / Mouse Mappings table appears on the Device Mode page.

ControlTypeLED
GOKeyboard / Mouse Click✔ (default blue)
STOPKeyboard / Mouse Click✔ (default yellow)
PAUSEKeyboard / Mouse Click✔ (default yellow)
Encoder PushKeyboard / Mouse Click–
Encoder CWKeyboard / Mouse Scroll–
Encoder CCWKeyboard / Mouse Scroll–
Push + CWKeyboard / Mouse Scroll–
Push + CCWKeyboard / Mouse Scroll–
HID mappings for buttons and encoder

The FrenschPress saves changes to type, key, modifiers, mouse action and LED colour immediately. There is no separate save step.

Keyboard​

For each control, choose modifiers and a key:

  • Modifiers: Ctrl, Shift, Alt, Cmd, in any combination
  • Key: a list with letters, digits, Enter, Escape, Backspace, Tab, Space, F1–F12, Insert, Home, PageUp, Delete, End, PageDown and the arrow keys

On a computer there is also Capture: the button takes the next key you press. On a phone, use the list.

Capture records the physical key code, so it is layout independent. A key captured on a German keyboard sits in the same physical position on the target computer.

Mouse​

TypeOptions
Mouse Click (buttons and encoder push)Left Click, Right Click, Middle Click
Mouse Scroll (encoder turns)Scroll Up, Scroll Down, Scroll Left, Scroll Right

LED​

STOP, GO and PAUSE each take their own LED colour. The defaults are blue for GO and yellow for STOP and PAUSE.


Relationship to the other USB roles​

The USB 2 port has three roles that exclude each other:

RoleMeaning
USB MIDI deviceDefault: class-compliant MIDI in both directions
USB HID deviceHID Mode, see above
USB hostStream Deck or LTC dongle

Every change requires a restart of the USB 2 part.


Troubleshooting​

SymptomCauseFix
QLab or other software no longer receives MIDIHID Mode is activeDisable HID Mode in Settings
Macros and Companion do not respondHID Mode is activeAs above
Stream Deck or LTC dongle is not detectedUSB 2 runs as HID device instead of USB hostDisable HID Mode and turn on USB Host Support in Settings
Capture is missingThe web interface is open on a phonePick the key from the list