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.)
    open in
  2. Alternatively, in iOS 8 and above, you can tap the Import button at the top of the Documents list and select documents to import from other compatible apps.
  3. 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, click it in the iTunes sidebar; then click the Apps tab for your device; then scroll down to the File Sharing section and click Set List Maker; then drag documents into the list. For more info on iTunes File Sharing, click here.
    file sharing
  4. 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.
  5. 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
  6. 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
  7. 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 or toggle 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.
    annotation toolbar
  • 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.
  • 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 sync your database to another device, Set List Maker will sync the file name (iOS) or file path (Android) for each attached document, but will not sync 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 syncing, 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 sync your document files.)
  • 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 with JPEG files in iOS 6 and earlier and doesn't work with the Photos app in iOS 7. However, you can save JPEGs to your photo library, then tap the Photos button in the list of documents, and select the JPEG 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.