DocumentationPedal & HID keyboard

Pedal & HID keyboard

Being able to drive stage mode with your feet is worth a lot on stage. Eutepio solves it the simplest possible way.

How it works

ℹ
The app contains no Bluetooth stack and does not pair with devices itself. It receives keys as the operating system hands them over — exactly as if somebody pressed them on a keyboard.
So anything that presents itself to the system as a keyboard will work: a Bluetooth page-turner pedal, a USB foot switch, a presenter remote, or a plain keyboard on desktop.
Since 0.2.5, any key can trigger any action. Before that four keys were hardwired, which was the most common cause of "the pedal doesn't work" reports — the pedal was sending something other than what the app was listening for.

Learn a key

In Settings → Pedal / HID keyboard:
  1. Choose Learn a key.
  2. Step on the pedal or press the key.
  3. The app remembers what arrived and lets you pick an action for it.

You can add mappings, remove them, or reset to the defaults. There is no limit — if your pedal has six buttons, give each one an action.

✦

If you are not sure what your pedal sends, just teach it. You do not need to know whether it is Page Down or something else — the app finds out for you.

Available actions

ActionWhat it does
Next songMoves to the next song in the setlist
Previous songMoves to the previous one
Scroll downScrolls the lyrics down a step
Scroll upScrolls up
Auto-scroll start / stopToggles automatic scrolling
Metronome start / stopToggles the metronome
Cycle displaySteps through the display modes
Send MIDI commandSends the manual MIDI command from settings — see MIDI
NoneIgnores the key

That last option is handy when your pedal has a button you keep catching mid-song.

Default mapping

Until you set anything up:

KeyDefault action
Arrow Right / Page DownNext song
Arrow Left / Page UpPrevious song
Arrow Down / SpaceScroll down
Arrow UpScroll up

Most pedals send exactly Page Up / Page Down or arrows, so usually you just switch it on and it works.

Pairing

Pairing is handled by the operating system, not the app.

Android

  1. Put the pedal into pairing mode (usually by holding a button).
  2. Settings → Connected devices → Pair new device.
  3. Pick the pedal from the list.
  4. Open Eutepio and enter stage mode — the keys work immediately.

iOS

  1. Put the pedal into pairing mode.
  2. Settings → Bluetooth.
  3. Pick the pedal from the list.

Windows

A Bluetooth pedal pairs through Settings → Bluetooth & devices. A USB pedal just needs plugging in. On desktop a regular keyboard works too.

Troubleshooting

The pedal does nothing

  1. Check it is paired at the system level — open a notes app and see whether presses register.
  2. Check that you are in stage mode. Keys are only handled there, not in the library or the editor.
  3. Use Learn a key. If the pedal registers nothing during learning, the system does not see it as a keyboard and the problem is in pairing.

The pedal does something other than expected

Go through the mappings in settings and reassign as needed. The defaults assume the "forward" button sends Page Down.

I want to drive the app from a keyboard instrument

That is what MIDI input is for — see MIDI.
← PreviousNext →