Attaching documents to your songs

If you have any documents for a song, such as a chord chart, lyric sheet or music notation, you can upload those documents into BandHelper and then attach them to the song. Then a document button will appear in song lists, which you can click to view the documents. You can also attach documents to events (e.g., performance contracts), contacts (e.g., photos) and transactions (e.g., receipts) using the same process described below. You can watch a tutorial video, or read on for more details:

Note: You can attach documents in .pdf, .jpg and .txt formats. If you have documents in another format, you can export them as PDFs from the application in which you created them, or batch-convert them using a tool like this one.

Note: Attaching documents is similar to adding lyrics, but not the same. You can use this comparison chart to understand the differences.

Adding individual documents to BandHelper from the website

  1. Click the Edit button for a song, event, contact or transaction.
  2. Click the Add Document button.
  3. In the popup window that appears, click the file selection button, then browse to the file on your computer and select it. The file name will be copied into the Name field automatically, but you can enter a new name if needed.
  4. Change the document orientation to Landscape if needed; this helps the app display the document correctly.
  5. If you only want some users to see this document, select the desired users.
  6. Click Save. Now the document will upload to your account, the popup will close and the document name will appear on the edit page.
  7. If your document is too large to upload and download easily, or exceeds the file size limit, click the Copy To Devices Manually option instead of selecting a file. Then you can install the document directly into BandHelper's data folder on your devices.
  8. You can repeat these steps to add more documents, then drag and drop to rearrange them. Then click Save on the edit page.

Adding individual documents to BandHelper from the iOS, Android or macOS app

  1. Navigate to the Songs, Events, Contacts or Transactions list and click an item to edit it.
  2. Click the Add Document button.
  3. In the popup window that appears, click the File button. This shows any files that have been added to BandHelper's data folder that have not already been attached to an item. In most cases, the file you want won't be here yet, so click the Import button in the top toolbar. Then you can browse and select a file from any location your device can access, including local or cloud folders.
  4. After selecting a file, the file name will be copied into the Name field automatically, but you can enter a new name if needed.
  5. Change the document orientation to Landscape if needed; this helps the app display the document correctly.
  6. If you only want some users to see this document, select the desired users.
  7. Click Save. Now the document will upload to your account, the popup will close and the document name will appear on the edit page.
  8. If your document is too large to upload and download easily, or exceeds the file size limit, click the Copy To Devices Manually option instead of selecting a file. Then you can install the document directly into BandHelper's data folder on your other devices.
  9. You can repeat these steps to add more documents, then drag and drop to rearrange them. Then click Save on the edit page.

Adding a batch of documents to BandHelper from the website

  1. Zip your documents together into a file up to 500MB in size.
  2. Log into the website and go to the Documents page of the Repertoire, Schedule, Finance or Contacts section.
  3. Click the Batch Import form at the top of the page and select your zip file.
  4. To only attach documents to existing songs, leave Add New Songs deselected. To create new songs for any documents in the zip file that don't match an existing document or song name, select Add New Songs.
  5. Click Submit. This will upload all the files, which could take up to an hour depending on your Internet connection.

When the upload is complete, BandHelper will create new songs containing the contents of any ChordPro and Onsong documents, then discard the documents. For other document formats, BandHelper will…

  • Replace existing documents that have the same name.
  • Attach new documents to a song, event, transaction or contact with the same base name. For example, a document named "Freebird - horns.pdf" will be attached to a song named "Freebird."
  • Add a new song (or event, transaction or contact) for any documents whose names don't match any existing items, if Add New Songs is selected.

Viewing documents from the website

After you've attached a document to a song, event, contact or transaction, you should see a document button Document button appear next to that item whenever it appears. Clicking the button opens the default document, which is the first one in the list for that song. If you have attached more than one document, you can hover over the button until a submenu appears, then click the desired document name.

Documents you view in the website have the following features:

  • Scroll up or down to change pages in a multi-page document, or click the right or left arrow buttons to view additional documents or lyrics attached to the same song.
  • Alternatively, use the up and down arrow keys on your keyboard to change pages, the right and left arrow keys to change documents and the escape key to close the document viewer. (You might have to click the document viewer before the keyboard messages are correctly routed to the document.)
  • Click the +/- buttons in the viewer toolbar to zoom the document in or out.
  • Tap the download button in the viewer toolbar to save a copy of the document to your computer.

Viewing documents from the iOS, Android or macOS app

After you've attached a document to a song, event, contact or transaction, you should see a document button Document button appear next to that item whenever it appears. Tapping the button opens the default document, which is the first one in the list for that song (unless you change Settings > General Settings > Defaults > Document). If you have attached more than one document, you can tap and hold the button until a submenu appears, then tap the desired document name.
documents list

Documents you view in the app have the following features:

  • Swipe up or down to scroll through long documents, or tap the top or bottom third of the lyrics to snap to the previous or next page.
  • Pinch to zoom the document in or out.
  • Tap the left or right third of the document to switch to adjacent documents, if multiple documents are attached to the same song.
  • Double-tap the center of the document to expand it to full-screen view. Double-tap again to exit the full-screen view.
    document hotspots
  • Tap the document tools button in the top right corner to save the current zoom level (for PDF files only), reset the zoom level, add or save annotations, add markers, change the Fit to Height setting or toggle in and out of full-screen display.
    document tools
  • From the annotation toolbar, select the pen, highlighter, text and whiteout tools to write directly onto your document. Select the eraser tool to remove individual annotations, or double-tap the eraser to remove all annotations. While adding annotations, you can scroll the document with a two-fingered drag.
    annotation toolbar
  • To add markers, scroll the document to the desired position, then click Add a Marker in the tools menu and enter a name for the marker. You can also click an existing marker to rename or delete it. When your document contains markers, all the Next Page and Previous Page functions (including the on-screen hotspots, automation events and remote control actions) will jump to the marker positions instead of the page positions.
  • From a set list only: If an arrow appears in the document icon, tap it to begin auto-scrolling.

Additional notes about documents

  • The Android app can invert PDFs to match the dark color theme using Settings > Appearance > Invert PDF Colors. The other platforms can only show PDFs in their natural color. To show them as white text on a black background, you would have to change the colors within your original document and re-export it as a PDF (or use the built-in Lyrics field instead).
  • To display documents correctly, BandHelper needs to know the size of your documents. You can tell BandHelper whether you're using Letter or A4 documents in your account with the Settings > General Settings > Document Size option. BandHelper doesn't support a mixture of Letter and A4 documents in the same account and doesn't support custom page sizes. Some functions won't work correctly if your document sizes don't match the Document Size setting.
  • BandHelper also needs to know the orientation of your documents. It assumes documents are portrait oriented, but if you have any landscape documents, you can specify that: go to the Repertoire > Documents page, tap the name of a landscape document and select the Landscape option.
  • You can display your documents in two columns if you edit your layout, tap the document viewer, tap its options button in the top right corner, and set Content to 2 Columns. Then tap the document tools button and select Fit to Height to display two pages side by side. Or you can set the number of columns for individual documents with the Presentation setting on the document edit page.
  • If you are using an external display with your device, that display will mirror your entire screen by default. Alternatively, you can set Settings > General Settings > External Display to Document, and then the external display will only show the document when you view it from within a set list. Your layout does not need to include a document viewer to use this feature, so you could view a list-only layout or other information on your device display and a document on your external display.
  • You can email or print individual documents after clicking a document name in the Documents list. You can email or print a collection of documents by selecting a show or smart list and clicking the Share Songs button.
  • The iOS "Open in..." command doesn't work in the Photos app in iOS. However, you can save JPEGs to your photo library, then tap the Photos button in the Add Documents window in BandHelper, and select the photo from the photo library.
  • If you have created your document by scanning a piece of paper, the file size will be relatively large, which will make the document open slowly when you view it within the app. The best documents are created from an electronic source such as a Word or Pages document. If you don't have an electronic source, you can experiment with your scanning settings to minimize your file sizes. Most documents can be scanned in black and white, with 100-150 dpi for regular displays or 200 dpi for Retina displays.