Attaching documents to your songs

If you've created documents for your songs in another application, such as a chord chart, lyric sheet or music notation, you can copy those documents into Set List Maker (iOS) or onto your device (Android) and then attach them to the song records. Then a document button will appear in song lists, which you can tap to view the documents on your device. You can watch a tutorial video, or read on for more details:

Note: If you first installed the iOS app between versions 3.0 and 3.4.5, attaching documents requires an in-app purchase. If you only need to add text to a song, you can use the Lyrics field in each song without an in-app purchase.

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

  1. To copy documents into Set List Maker on iOS, view the document from another app on your device and look for the "Open in..." command. For example, if someone emails you a document as an attachment, you can tap the document from the email message, then tap "Open in..." and choose Set List Maker. You can also find the "Open in..." command in file sharing apps like Dropbox and word processing apps like Documents To Go. Unfortunately, Pages does not support this feature; to copy a document from Pages you would have to email it to yourself, then use "Open in..." from the email message. This method only lets you copy one file at a time.
    open in
  2. In iOS, you can tap the Import button at the top of the Documents list and select documents to import from other compatible apps. This method only lets you copy one file at a time.
  3. In iOS 11 and above, you can open the Files app and browse to where your documents are stored in another app or cloud storage account. Click the Select button and select the documents you want to copy, then click the folder icon and select On My iPhone/iPad/iPod > Set List Maker.
  4. If you want to add several documents at once, you can drag documents into the iOS app with the file sharing feature in iTunes. With your device connected, select it from the device button in the top toolbar of iTunes; then click File Sharing in the left sidebar; then scroll down in the Apps list and click Set List Maker; then drag documents into the list. For more info on iTunes File Sharing, click here.
    file sharing
  5. To use documents in Set List Maker on Android, you only need to have your documents saved somewhere on your device. Set List Maker will link directly to your document locations. However, this means if you move your documents, you will break the links in Set List Maker. This also means if the Android OS changes its directory structure, or if you migrate to a new device that uses a different directory structure, your links could break. You can avoid these problems by keeping all your documents in one directory and selecting that directory in Settings > General Settings > Defaults > Document Directory. Then if you need to move or rename that directory, or the device's directory structure changes, you can simply update that setting and all the links will be updated automatically.
  6. Once the documents are on your device, open a song edit window and scroll down to the Documents list, which will show any documents already attached to a song.
    edit documents
  7. To attach documents, tap the Add Documents button. On iOS, this will open a list of all the documents copied into Set List Maker. On Android, this will open a file browser window. You can tap the buttons at the top of the window to sort them in different ways, or tap the Search button to search for a document. Then tap the documents you want to attach to your song; a checkbox will appear next to each document you've selected. When you're done selecting documents, tap Save.
    choose documents
  8. Your selected documents will appear in the previous window. If needed, you can rearrange this list by dragging the "grip" area to the right of each document. The first document in the list will be the default document throughout the app. When you leave the song, your changes will be saved automatically.
    edit documents

After you've attached a document to a song, you should see a document button Document button appear next to the song whenever the song appears in Set List Maker. 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

When you view your document from the Songs list or from a song in a show, you can use the following features:

  • Swipe up or down to scroll through long documents, or tap the top or bottom third of the lyrics to jump to the previous or next page.
  • Tap the left or right third of the document to switch to adjacent documents, if multiple documents are attached to the same song.
  • Pinch to zoom the document in or out.
  • 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 show only: If an arrow appears in the document icon, tap it to begin auto-scrolling.
  • From the Songs list only: Tap the Email or Print buttons to email or print the lyrics.

Here are some additional notes about attaching documents:

  • Set List Maker on iOS can display .pdf, .doc, .docx, .ppt, .pptx, .pages, .key, .rtf, .txt or .jpg documents. Set List Maker on Android can only display .pdf, .txt and .jpg documents.
  • Word (.doc and .docx) and RTF files have black text by default, so if you view a Word or RTF file in Set List Maker, the app will place a white background behind it so you can read the text. If you want to use a dark color scheme, you can edit your file to use white text on a black background, then change Set List Maker's Settings > Appearance > Word Document Colors option to Inverted so it won't place a white background behind it. Plain text (.txt) files always have black text, so Set List Maker will always place a white background behind a text file.
  • The iOS framework for rendering documents doesn't always size Word and Pages files correctly on the screen. If you find that your documents are showing with two pages in Set List Maker but they should only have one page, this might be the problem. If you convert your documents to the PDF format, they should always be sized correctly.
  • To display documents correctly, Set List Maker needs to know the size of your documents. You can tell Set List Maker whether you're using A4 or Letter documents on a database-wide basis with the Settings > General Settings > Document Size option. You can also tell Set List Maker whether your documents are portrait or landscape orientation on a document-by-document basis: tap the Documents menu item in your database, then tap the Edit button for each landscape document and tap the Landscape option. Set List Maker assumes documents are portrait oriented, so you only need to do this for your landscape documents.
  • 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.
  • If you are using an external display with an iOS 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 show. Your show 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.
  • If you export your database to another device, Set List Maker will copy the file name (iOS) or file path (Android) for each attached document, but will not copy the file itself. If you install the document with the same location on the other device, the document icon will appear for display on that device. If the document icon does not appear after importing, please be sure that the document is available on the other device with exactly the same name. On Android, only the part of the file path after the Settings > General Settings > Default > Document Directory needs to match. (If you switch to BandHelper, it will copy your document files to all the devices in your band.)
  • To rename a document copied into the iOS app, tap the Documents menu item in your database, then tap the document name, then enter a new name. All the songs to which this document is attached will be updated with the new name.
  • To delete a document copied into the iOS app, tap the Documents menu item in your database, then tap the document name, then tap the Delete button. Documents are shared across databases, so this will delete the document from all your databases and detach it from all the songs to which it is attached. Before deleting, you can review the list of songs below the edit fields that shows all the songs to which the document is attached.
  • Documents that are not attached to any songs in your current database will appear in a faded style in the Documents menu. However, these documents might still be attached to songs in other databases.
  • If you're adding your document to a new song, you can add the document before entering a song title and the song title will be automatically set to the document filename.
  • The iOS "Open in..." command can only show 10 apps in iOS 5 and earlier. If Set List Maker doesn't appear in this list and you have more than 10 apps that can view a given file type, you will have to uninstall some of the other apps until Set List Maker appears.
  • 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 Set List Maker, 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.