Controlling BandHelper from another device

You can watch a tutorial video, or read on for complete details.

Note: These features are only available in the set list view.

To control BandHelper with a Bluetooth device

Note: The Bluetooth devices mentioned here work like an external keyboard that you would type on, but with a small number of "keys." The buttons on a foot switch typically mimic the arrow keys on a keyboard.

  1. Find out what keyboard messages your device can send. For example, the AirTurn Duo sends up/down messages from the first two footswitches, and can send left/right messages from a second pair of switches. The iRig BlueTurn sends up/down messages with the default settings. The Coda Stomp sends left/right or up/down messages depending on the position of the Mode button.
    AirTurn DuoiRig BlueTurn  Coda Stomp
  2. Open the Settings app on your iOS or Android device, navigate to the Bluetooth page, and pair your Bluetooth device.
  3. Navigate to Settings > Remote Control > Actions and find an action that you want to trigger. Tap that action, then tap Foot Switch (Keyboard) Messages and select the keyboard message you want to trigger it with. For example, to select the next page of your lyrics when you send a down arrow message, tap Next Page and select Down Arrow. You can assign multiple actions to the same message if you want to several actions at once.
    remote control action
  4. Navigate to a set list or a smart list.
  5. Use your Bluetooth device to send messages to BandHelper. BandHelper will respond with the actions you configured.
  6. If you don't get the expected results, tap the Remote Control button (foot switch icon) in the top toolbar foot switch icon. If this button is not visible, you can show it by selecting Settings > Appearance > Top Toolbar Buttons > Remote Control. This button opens a status window. You should see messages that were received by the foot switch, and the actions they triggered, in the Activity Log. If the button at the bottom of the window says Keyboard Disabled, tap it to turn on keyboard input.
    keyboard status
  7. Since most Bluetooth foot switches mimic a text keyboard, iOS won't show the on-screen keyboard when one is connected. BandHelper will automatically enable the remote keyboard connection when you enter the set list view and disable it when you have access to a text input field, but if you end up in a text input field with no on-screen keyboard, you can might have to manually break the foot switch connection. Some foot switches have a button or a gesture (such as holding one of the buttons for a few seconds) to accomplish this; you can check your foot switch user manual for instructions. Alternatively, you can click the foot switch icon in the top toolbar and click the Keyboard Enabled label to disable it.
  8. Some AirTurn devices have an AirDirect mode that avoids conflicts with the on-screen keyboard on iOS. If you have an AirDirect-compatible AirTurn and switch it to this mode, you can click Settings > Remote Control > Set Up AirDirect AirTurn and turn on AirTurn Support. You should then pair your AirTurn device by selecting it in this window instead of in the iOS Settings app. If you do not have an AirTurn brand device, or it is an older AirTurn model that doesn't support AirDirect, or it is not in AirDirect mode, you should not use the Set Up AirDirect AirTurn button.
  9. You can connect multiple remote control devices and either map them to the same actions so that you can trigger actions from multiple locations on stage, or map them to different actions so you can trigger a larger set of actions. Most foot switches are configurable to send different keyboard messages, so for example you could have one two-button device configured to send up/down arrow messages and a second configured to send left/right arrow messages, to control four different actions.
  10. BandHelper will only receive Bluetooth messages while it is the foreground app, unless you are using an AirTurn in AirDirect mode, which also works in the background.

To control BandHelper with a MIDI device

  1. Find out whether your MIDI device can send Start/Stop messages, Song Select messages, Controller messages or Note messages. For example, the Alesis PercPad can send note messages, and the iRig BlueBoard can send General Purpose Button messages.
    Alesis PercPad Blueboard
  2. Navigate to Settings > Remote Control > MIDI Input Channel and select the channel on which your controlling device will send messages. If you do not set a channel here, BandHelper will listen on all channels.
  3. Scroll down to the Actions section and find an action that you want to trigger. Tap that action, then tap MIDI System Messages, MIDI Controller Messages or MIDI Note Messages and select the MIDI message you want to trigger it with. For example, to play the current song's recording by sending note 40, tap Recording Start/Stop and select note 40.
    remote control action
  4. Navigate to a set list or a smart list.
  5. The MIDI icon in the top toolbar should turn on to indicate that the app is ready to receive MIDI input: MIDI icon. If this button is not visible, you can show it by selecting Settings > Appearance > Top Toolbar Buttons > MIDI. Clicking this button opens the MIDI Status window. You can view connected ports and incoming MIDI messages in this window to test your connection.
    midi status
  6. Use your MIDI device to send messages to BandHelper. BandHelper will respond with the actions you configured.
  7. BandHelper on iOS, by default, will only receive MIDI messages while it is the foreground app, but you can turn on Settings > Audio & MIDI > MIDI Options > Receive MIDI In Background to change this. This setting will only take effect if you exit the app while viewing a set list. Since an app running in the background uses more power than an app that is allowed to go to sleep normally, you should be careful to navigate out of a set list before exiting the app when you are finished using the app. On Android, BandHelper will generally receive MIDI messages in the background, but this is not guaranteed and it depends on the memory usage of the other running apps.

To select specific songs with a MIDI device

Most remote control actions aren't tied to specific songs, but you can map MIDI messages to specific songs. Then if you have a MIDI device that makes it easy to send arbitrary messages, you can use these messages to navigate directly to the desired songs.

  1. Find out whether your MIDI device can send Song Select messages or Program Change messages. Song Select messages were designed for exactly this purpose, but are limited to 128 songs, and are less commonly used.
  2. Navigate to Settings > Remote Control, scroll down in the Actions list and click Song Number.
  3. Click either MIDI System Messages or MIDI Program Messages, then select Song Select or Program Change. (These are the only options for each message type.)
  4. Navigate to Settings > Audio & MIDI and turn on Assign Song Select Numbers or Assign Incoming Programs. You will need this to enter song values in the next step.
  5. Navigate to Repertoire > Songs and click a song title to edit it. You'll see either a MIDI Song Number field or a MIDI Program Change field, with accompanying Bank MSB and LSB fields. Enter unique values between 0 and 127 into these fields.
  6. Program your MIDI device to send the values you entered for each song.
  7. Navigate to a set list or smart list that contains the songs you want to select. Then send the messages you programmed from your MIDI device.

Alternatively, you can use a Song Select or Program Change message to select songs by their position in the set list view, using the Song Number In Set List action on the Settings > Remote Control page. For example, you could send song number 4 to select the 5th song in the list (MIDI messages are numbered from 0), song number 10 to select the 11th song, etc.

To control BandHelper with another mobile device also running BandHelper

If you have BandHelper running on multiple devices, you can broadcast actions like selecting songs or changing pages from a lead device for the others to follow. Please see the Live Sharing tutorial for details.