Getting Started

  • You can tap in different areas of the screen. Note - all screen images are of iOS7. If you are running any iOS before iOS7, the images will look slightly different.

  • The top toolbar is what you will be using most of the time.

  • The first thing that you must do is get PDF files into unrealBook. There are several ways to do this. Using iTunes is the main way to load a number of PDF files into unrealBook. All PDF files that are in the unrealBook Documents folder will be listed in the Songs menu.

  • It's easy to choose a song/PDF file.

  • In addition to allowing you to search and load songs quickly, unrealBook allows you to create set lists for live performance. Set lists allow you to turn through a pre-determined list of songs as well as jump directly to any song in the set list quickly.

Go Button

Do Button

dB Button

Music Button

Drawing Button

Action Button

  • Share PDF allows you to email or copy a PDF with our without annotations (drawings) to another application or to anothe iPad via AirDrop.

  • Choose this to send a comment about unrealBook.

  • If you are connected to another iPad using Bluetooth, the current file that is shown can be sent to the other iPad. Only available when a Bluetooth connection has been made.

  • If you are connected to another iPad using Bluetooth, the current set list that is selected can be sent to the other iPad. Only available when a Bluetooth connection has been made.

  • Choose this to print a PDF to a compatible iPad printer.

Settings

  • Use the File->MIDI window to send optional MIDI data through a MIDI interface connected to your iPad when a PDF is loaded.

  • These control how unrealBook operates.

  • Access info about unrealBook. Version information and more.

Advanced

  • Lists are a way of displaying a subset of all the charts you have. For example if you are playing with a Jazz band, you might want to only see charts that pertain to that Jazz band. Lists are similar to set lists, except they are in the Songs menu. In addition, they are sorted and indexed automatically. When you search through a list, only the songs in the list are searched

  • Indexes allow you to create a file containing a list of titles and pages for a specific document. Think of it as a table of contents that you can create for a large PDF book. unrealBook now includes an index editor so you don't need to use a computer to create and edit indexes.

  • Indexes allow you to create a file containing a list of titles and pages for a specific document. Think of it as a table of contents that you can create for a large PDF book. At this time unrealBook doesn’t have an interface for creating this, but you can use a spreadsheet application to create this file. To create an index, type in the name of the song, the document name and the page number in a spreadsheet.

  • If you regularly use Dropbox.com, you can download PDF files from your Dropbox folder using the remote files command in the action menu.

  • You can use a Bluetooth Pedal to turn pages wirelessly with unrealBook.

  • You can use an iRig Blueboard pedal to control unrealBook wirelessly. There is no setup to do in unrealBook unless you have turned off MIDI Recv in the Settings->Global->More Options... The default setting is ON. Make sure the Blueboard is paired to the iRig Blueboard app on the iPad. You will need to pair the Blueboard to the iRig Blueboard app every time you turn it on

  • You can connect two or more iPads via Wifi so that one iPad can control multiple iPads (File loading and page turns).

Misc.

  • Problem: unrealBook is acting strange - something used to work, now it doesn't.
    Try to completely quit unrealBook. Double-press on the Home button to access the task bar. Press and hold on the unrealBook icon until it wiggles. Press the minus sign at the top left of the icon to completely quit the application. Try and run unrealbook again.

    Problem:
    You want to be able to remember the songs that you played in a large pdf book and want to quickly access those songs again.

    Solution - use Bookmarks.
    Select Add Bookmark from the Do Menu. Name the bookmark. Now the bookmark will appear in the main song list like any other file. Choose it to load the book and go directly to the song.

    Solution2 - use Export Pages.
    Tap the Action Menu and choose Export Pages. The advantage of export pages over a bookmark is that Export Pages creates a new file that may load faster.

    Problem:
    You need to quick way to recall songs that you need on the gig tonight.

    Solution - Use the set list feature in the Do Menu.
    Create set lists using the set list feature and use the set list song popup to quickly access any song in the set list on the fly.

    Problem:
    You need to quick jump to another page due to a d.s. or to coda mark.

    Solution - Use the Hot Spot feature in the Do Menu.
    Create Hot Spots and assign the page to jump to.

    Problem:
    You have a large "real book" type PDF with hundreds of pages. People are calling out songs on the fly. You need a way to get to the index page fast and a way to jump to the correct page number. The problem is that the page numbers don't match what the PDF is telling you. Page 1 visually is really page 6 due to the cover page and notes.

    Solution - Use the Go Menu buttons.
    Turn to the index page and hit the M+ button in the Go menu. Now any press on the M button will take you quickly to the index page. Now go to the first page that shows Page Number 1 visually (which could be page 6 etc....), now press the Set Page 1 button, now when you type any value into the Page: [] field, the correct page will be brought up. (Note: this will not work for PDFs with negative page offsets)

    Solution2 - Create an index for the PDF. Although this requires work ahead of time, you can create a searchable index for any large PDF in unrealBook.

    Problem:
    You need to put a note to remind yourself to press program 8 on your keyboard during a section.

    Solution - Use the Add Text button in the Do Menu.
    Select the Add Text button in the Do Menu and then press any where in the score. Now type in "program 8" and hit return. The note is placed on the score and automatically highlighted.

    Problem:
    You need to skim through a book quickly.

    Solution:
    Use the Go Menu -10, -2, -1, +1 +2 and +10 buttons to jump through the document quickly along with the Go Menu slider.

    Problem:
    You need to send someone a PDF or an annotated version of the current PDF.

    Solution - use the Action menu.
    Press on the Action menu and choose from the various email choices. WARNING: do not choose Email ALL Screen Shots with a huge file because there is a limit to the maximum size and attachments that most email systems can handle. Use this for a maximum of 10 pages.

    Problem:
    You need to delete a file/bookmark or rename a file.

    Solution - use the Do Menu->Manage Files command.
    Choose the Manage Files command in the Do Menu and select, then rename/delete your file.

  • A word about the support files that unrealBook creates:

    unrealBook will create support files as you use it. Here is a short explanation of what the files do.

    .bkm are Bookmark files that unrealBook creates . They point to a document and the page within. They have the same name as the associated file. Note: in order for Bookmark files to work properly the document they point to must be in the unrealBook folder.

    .stl are Setlist files. They are simply a list of songs in order. Note: in order for Setlist files to work properly the document they point to must be in the unrealBook folder.

    .prs are Hot Spot files. They contain your Hot Spots for your document. They have the same name as the associated file. Note: in order for Setlist files to work properly the document they point to must be in the unrealBook folder.

    .sn? files contain music links.

    .prefs store the zoom and other misc info about your files.

    All of these files can be viewed in TextEdit.

    Important Note:

    If you want to delete or rename files, please use unrealBook's File window to do this. The reason is that set lists reference songs and bookmarks, bookmarks reference songs. If you delete or rename songs or bookmarks, other files that reference the changed file need to be modified.

  • Credits:

    Many thanks to the users and testers of unrealBook! Thanks for all of your suggestions and help!

    Special thanks to:

    Aldo Alibrandi
    http://www.sydneypartybands.com.au

    Scotty Huff
    www.ScottyHuff.com
    www.TimothyScottEntertainment.com

    Jim Laing

    Joanna Jordan 
    www.joannajordan.com

    Ricky Wong

    3rd Party Credits
    unrealBook includes PDF code by Created by Julius Oklamcak ® Copyright 2010.
    unrealBook includes music media picker code by Jamin Guy ® Copyright 2011.
    unrealBook includes VGA support code by Matt Legend Gemmell ® Copyright 2010.
    unrealBook uses SVProgressHUD, SVPullToRefresh by Sam Vermette ® Copyright 2014.
    unrealBook uses ZipArchive, Copyright 2008.
    unrealBook uses AFNetworking, Copyright 2011.
    unrealBook uses Ground Control by Matt Thompson, Copyright 2012.
    unrealBook uses BlockUIAlertVIew by Random Ideas, LLC Copyright 2011
    unrealBook uses iRate by Nick Lockwood, Copyright 2011.
    unrealBook uses PGMidi by Pete Goodliffe, Copyright 2010.
    unrealBook uses MTStatusBarOverlay by Matthias Tretter Copyright 2009.
    unrealBook uses UIImage+Resize.h by Trevor Harmon Copyright 2009
    unrealBook uses KGDiscreetAlertView by David Keegan Copyright 2012
    unrealBook uses patterns from subtlepatterns.com