Changing your song layouts

BandHelper allows you to select from several predefined layouts in the set list view, or customize the layouts to display exactly the info you need during your performances. You can watch a tutorial video, or read on for more details:

Using the predefined layouts

  • When you select a set list from the main menu shortcuts, or select a set list from the Repertoire > Set Lists page and click the View button, the set list will appear with your default (last-used) layout.
    layouts view button
  • To try a different layout, you can click the Layout button in the bottom toolbar of the set list view. Alternatively, after selecting a set list from the Repertoire > Set Lists page, you can click the More Layout Options button under the View button. Then you will see all the layouts that match your device's screen size and orientation.
    layouts popup menu
  • Layouts can only be used in one orientation or the other (portrait or landscape). You can rotate your device to see the layouts that match the other orientation.
  • If you want to quickly switch between multiple layouts while performing, you can set up the Next Layout and Previous Layout remote control action or layout action. Then you can cycle through your layouts by clicking a foot switch button or swiping on the screen.
  • If for some reason your device doesn't show these predefined layouts, or only shows some of them, you can reload them by tapping Help > Utilities > Load Default Layouts. This won't affect any layouts you already have.
  • When you use BandHelper on macOS, the predefined layouts are not created automatically because of the variable window size. It's best to move the app window to the desired size first, then go to Help > Utilities > Load Default Layouts to create them. Also, the Load Default Layouts function on macOS will only create layouts for the current window orientation (portrait or landscape).

Customizing the layouts

  • From the Repertoire > Layouts list, you can see all the layouts installed on your device, with the layouts that match the current screen size and orientation appearing above a divider line:
    layouts list
  • To customize a layout, select a layout from this list, then tap Edit Layout. You will see the layout as if you are viewing a show, but you can now tap any item in the layout to select it, then drag to move it, drag the lower right corner to resize it, or tap the X button to remove it:
    layout editing
  • Some layout items have an options button in the top right corner. The options button on a song list allows you to control several aspects of the list display, like text size, song buttons and song fields. The options button on a text field allows you to set a color for the field or show a label with the field's name.
  • When resizing layout items, you can generally resize them to any proportion, but to return to the default proportion, you can double-tap the bottom right corner.
  • To move a number of layout items as a group, you can drag a selection area starting from an empty area of the layout and encompassing the desired items. You can then drag any item to move them together.
  • To add items to your layout, you can tap an empty area of the layout, then select a new item from the list that appears.
    add layout item
  • If you add a song list to your layout, it will always appear below the other items while editing, but it will always appear above the other items while viewing. This allows you to create a layout where you can hide or show the song list using one of the Song List buttons in your layout, or using a layout action, or using a remote control action.
  • If an item is selected for editing but you want to select an item behind it, you can click its options button and select Move To Back. If you want to place an item on top another item, such as a button on top the document viewer, you can click the exiting item's options button and select Add Overlapping Item.
  • You can add standard-sized (not resizable) text fields to the bottom toolbar by tapping one of the field slots, then selecting a field name from the list that appears. If you place any +1 or +2 items (which display info for the next song or the song after that) on the right side of the toolbar, BandHelper will move those fields to the right side of the screen. To clear one of the field slots, you can select Remove from the bottom of the list of fields.
    add layout field
  • You can the Song Edit, Layout Edit, Quick Add or Random Song buttons to the bottom toolbar by selecting your layout from the Layouts list and then tapping Edit Details. These buttons provide immediate access to some functions without leaving the set list view, but take up space in the bottom toolbar that you can reclaim by turning them off if you aren't using them.
  • You can turn on song selection and completion actions for a layout by selecting it from the Layouts list and then tapping Edit Details. See the Layout Actions section below for more info.
  • You can create a new layout from scratch by tapping the + button at the top of the Layouts list, or create a new layout based on an existing layout by selecting a layout, tapping Edit Details and tapping the Copy button.
  • If you copy a layout that was created with a different screen size, the copy function will prompt you to choose between scaling the layout to the current screen size, or keeping the original size. You will probably have to make some sizing adjustments to the new layout in either case.
  • By default, layouts will only be available to view on devices with the same screen size and orientation with which the layout was created. But if you turn on Scalable on the Edit Details page, the layout will be available on devices with the same orientation, and will scale to fit different screen sizes. This allows you to maintain a single layout for use across different device models. However, due to variations in screen aspect ratios, the layout might not use the full width or height of some screens.
  • Layouts created on macOS will have the Scalable option turned on by default, so your layouts will still be available if you resize your app window. However, it's best to decide what app window size you want and then load default layouts for that size.
  • On the Edit Details page, you can rename a layout by entering a new name, or delete it by tapping the Delete button.

Special layout items

Most of the items you can add to a layout are self-explanatory, but a few have special capabilities:

  • The Song List will display the songs in the set list as a scrollable list. It will always appear above the other items, so you can place the song list on top of other items and then show it temporarily when you want to select a new song. The options button on the song list leads to several options for controlling the display of the song list, such as text size, song buttons and song fields.
  • The Song List - Split View and Song List - Full Screen buttons allow you to show a song list that was added to your layout but hidden. These buttons only work if the layout contains a song list. The Song List - Split View button will show the song list at the size you chose when adding it to your layout, while the Song List - Full Screen button will show the song list at the full screen size regardless of its size in the layout. You can hide a song list by tapping one of the song list buttons again, or selecting a song with the Hide Song List layout action set to Song Selection, or using the Hide Song List remote control action.
  • The Document Viewer will display a song's attached documents, chords and lyrics or video. It will always appear below the other items, so you can place items on top of the document viewer if you wish. In this case, those items will be displayed with a semi-opaque background for better contrast against the document content. From its options button, you can set the document viewer to display in one or two columns, but the Presentation setting on individual documents and song lyrics can override this.
  • The Notes field places resizable and scrollable text onto your layout. You can pinch in or out to resize the notes text, and tap the tools button to show a menu with options to save or reset the text size.
  • The Document Button, Recording Button and MIDI Button will access the default document, recording or MIDI preset for a song when you tap it, but you can also tap and hold it to show a menu providing access to all the attached documents, recordings or MIDI presets.
    layout document button
  • The Multiple Document Buttons, Multiple Recording Buttons and Multiple MIDI Buttons will show a separate button for each document, recording or MIDI preset attached to a song. You can resize these items to lay out the buttons horizontally or vertically. If a song has more buttons than fit into the size you designated, the list of buttons will be scrollable. The Multiple MIDI Buttons also has an option to show either song-level MIDI presets, layout-level MIDI presets or both.
    layout multiple document buttons
  • The Page Buttons will display a button for each page of the current document or lyrics. You can resize this item to lay out the buttons horizontally or vertically.
  • The Recording Controls include a top row with play/pause buttons, next/previous buttons, a progress slider and a timer, and a bottom row with loop buttons and a speed control slider. If you only need the top row, you can resize this item to hide the bottom row.
    layout recording controls
  • The Master Volume includes a slider to control the output volume of all BandHelper's audio. If you enlarge this layout item, or scroll within it, you will see additional sliders to control the separate volumes for recordings, videos, tempos and starting pitches. You can orient the sliders horizontally or vertically depending on how you size this layout item.
    volume sliders
  • The Box and Line items allow you to add simple design elements to organize your layout. Boxes always appear as a background behind other items, and lines can be either horizontal or vertical depending on how you size them.

Layout Actions

You can also assign shortcuts to some of the functions available in the set list view, at the layout level. These are called layout actions. From the Layouts list, tap Edit Details, then tap any of the actions listed there. Then select one of the following triggers:

  • Song Selection: This trigger is fired when you select a song, either by tapping its name in the song list, swiping between songs, using the Next/Previous buttons to change songs, using a foot switch or other remote control device, or auto-advancing with the Select Next Song layout action. This is useful for starting one or more functions automatically when selecting a song.
  • Song Second Selection: This trigger is fired when you select the same song twice. This allows you to select a song once to view it, then select it again to trigger some actions. Or you can trigger some actions on the first selection and trigger other actions on the second selection. For example, you might want to send your MIDI presets immediately on the first selection, then look at the song for a moment before selecting it again to start a backing track.
  • Two-fingered tap: This trigger is fired when you tap with two fingers anywhere on the screen. This generally requires less accuracy than tapping a button, so you can use it to trigger any functions that you need to access quickly during a performance. (Currently, two-fingered tap gestures are not supported on Macs.)
  • Three-fingered tap: This is similar to the two-fingered tap, and allows you to access additional functions by tapping three fingers. (Currently, two-fingered tap gestures are not supported on Macs.)
  • Left swipe: This trigger is fired when you swipe horizontally from right to left anywhere on the screen. By default, this is mapped to the Next Song action, but you can change it to another action like Next Document, Next Layout or Next MIDI Preset. You can also disable it to eliminate accidental song changes.
  • Right swipe: This is similar to the left swipe, and is mapped by default to the Previous Song action.
  • Song completion: This trigger is fired when a song's recording, video or automation track ends (whichever is later), or when the song duration is reached, if the song doesn't use a recording, video or backing track. You can use this to "clean up" after a song by stopping a tempo click, closing a full-screen document or opening a song list, or to trigger the Select Next Song action to auto-play through your set list.

Sharing layouts

Your layouts are synced across all your devices, but only the layouts matching the device screen size and orientation will appear when viewing a set list.

Since layouts are typically personalized for each user, layouts will be assigned only to the user who created them by default. However, you can share a layout with other users by selecting them on the Edit Details page.

You can also share layouts with users in other accounts via email:

  • When viewing a layout you want to share, tap the Layout button and select the Email option. A new email message will appear, with the layout attached as a text file. You can address and send this message.
  • To import a shared layout on iOS, tap the Layout button and select the Import option, then select the layout file from a compatible app. Or select the layout in a different app and use the Open In feature to copy it into BandHelper.
  • To import a shared layout on Android, tap the Layout button and select the Import option, then select the layout file from a folder on your device.
  • BandHelper will add the selected layout to your Layouts list.
  • BandHelper will not import layouts that were saved on a device with a different screen size.