How things work – Bookmarks, indexes, TOC

Every now and then someone wants to know about how to handle their PDF files – specifically PDF books etc…. Let me try and explain….

For simple one song per PDF, there are no problems. You search for them by name, call them up and add them to set lists. There are no problems with this.

The problems occur when there are two or more songs in a PDF. The user wants to access the songs as if they were individual songs.

The biggest problem is that the PDF file usually has absolutely no info about what it contains.

Some people say – why not do a text search? This doesn’t work for a large majority of PDF files. They are images and don’t contain text.

There are several ways unrealBook tries to help:

Bookmarks: Creating a bookmark will make a file that “points” to a page in a PDF. You can search for these bookmarks and add them to set lists just like any other file. The disadvantage is that you need to create a bookmark for every song you have.

Table of Contents (TOC) in a file via the Go Menu: This works for dialing up songs in a PDF. The advantage is that it’s built into the PDF. The disadvantage is that hardly any PDFs have a table of contents in them. You can create your own Table of Contents using an app like PDFOutliner. BTW: Table of Contents are also called “Outlines” in PDF speak. As of unrealBook 1.93 you can create an index from the table of contents.

Indexes: This is the ultimate solution for being able to dial up any song in a PDF. Index files (.csv) allow you to create a file that describes a PDF book in a way that you can call up songs by a user-defined name and easily add them to set lists. In addition, you can reference ANY PDF in an index. You can make your own custom lists that point to any file and page. Disadvantage is that you need to create this with a spreadsheet app but once you create it, it’s done and works great. Once an index (.csv file) has been created, copy it into the unrealBook documents folder like any other PDF and rebuild the All Indexes list by pulling down on it. The newly added index will appear in the various index lists.

Read about how to create an index.

Create index with Excel

Create index using the Index Editor

Basically there are 2 main ways to access songs; by filename or by index. That’s why you can call up All Indexes from the All Files menu.

In addition, Quick Find merges the two methods into one large list.

Here are some indexes for real books which are found on the internet. They may work right away. Some might need to be adjusted for your copy of the Real Book. Copy the files into your unrealBook documents folder like any other PDF.

http://diystompboxes.com/unrealbook/csvindexes/

Airturn PED Pedal info

CHANGING THE MODE

  1. Turn on the PED.
  2. Press and hold the MODE button. The red
    LED will flash once per second from 1 to 6
    flashes. The number of flashes corresponds
    to the same MODE number. Be sure to count the flashes.
  3. Release the MODE button following the number of flashes that reflects the desired MODE. The blue and red LEDs will flash together the number of times indicating which MODE has been set.

Example: To set MODE 2 hold the MODE button for 2 flashes of the red LED, release and both LEDS will flash 2 times to confirm the MODE 2 setting.

Note: Once the MODE has been set, it will remain the same until it is changed following the above steps.

Reset pairing:

Pairing must be reset whenever switching from one device to another or when switching between MODES 1 and 2.

With the PED powered on, press and hold the power button for six seconds. After two seconds, the PED will appear to power down. Continue to hold the power button. At six seconds both LEDs will blink three times. After the third blink release the power button. The device has been reset. Remove any old pairing from your host computer and then turn on the PED to pair again with the desired host computer.

PAIRING IN PED-APP-DIRECT MODE 1

Note: This MODE is for PED-APP-Direct apps only.

  1. Power on the PED.
  2. Be sure the PED is in MODE 1.
  3. Go to your app and find the Bluetooth setup screen.
  4. Find the PED in the device list and tap on it.
  5. Tap on the Pair option in the dialog box.

PAIRING IN MODE 2-6

Open your computer’s Bluetooth Setup dialog:

iOS – Select Settings>Bluetooth and turn on the Bluetooth if it is off. When the PED is discovered, it will appear in the list of devices. Tap on the selection. A dialog box will then appear. Tap on Pair.

Android – Select Settings>Bluetooth and turn it on if it is off. Make sure your device is set to discoverable. Then tap the SCAN button. When the PED appears, tap to pair.

PC – Select Control Panel, My Bluetooth Devices. Select “Add a device”. Click next and complete pairing.

MAC – Select Apple, System Preferences, Bluetooth and turn on Bluetooth. The PED will appear in the Devices window

iOS/iPadOS 15 so far

7-23-21

unrealBook works with iOS15 for the most basic functions.

MIDI has been tested and works as it always did.

Bluetooth master/slave seems to have issues – while I have made changes, this feature could be on the way out. I recommend Airdrop and Wifi for master/slave. A portable Wifi router is good enough.

More Functions

Accept multiple files without renaming: If you are airdropping a bunch of files, you can send multiple files to unrealBook. It will accept all the files overwriting any duplicates. Use this with caution.

Insert songs at top of setlist: When inserting songs into a set list, add them at the beginning instead of the end.

Apostrophe and sorting

The “smart” keyboard for the iPad Pro seems to type in a different apostrophe character than the iPad itself. This can result in weird sorting problems. To fix this, use the on screen keyboard or set the Smart Keyboard “U.S. International – PC”. Set this in the settings app of the iPad under Hardware Keyboard.

Nothing lasts forever – bluetooth pedals

Having worked on unrealBook for over 10 years now, I have been fortunate to use different bluetooth pedals with unrealBook. Unfortunate as it may be, with barely any use my CODA Stomp now refuses to connect to any device, my iRig Blueturn refuses to connect in a similar fashion with the error “pairing took too long” and now my iRig Blueboard is dropping connections sometimes within seconds and other times after a few minutes.

I am at a loss to explain how a bluetooth pedal can decide to no longer connect. They broadcast to the iPad because I can see them, but when I try to connect they donʻt connect. In fact, the CODA Stomp will lock up with the LED turning off and the power button stuck on.

I have to point out that my Airturn pedals all continue to work and pair.

Remapping an entire index (.csv) to a single PDF

Here is a common problem. The index points to a PDF but the PDF name is not the same. One way to fix this is to look inside the index (.csv file) and rename the PDF file to match what is in the index.

Another way is to use the Link to new PDF command. Be aware that this will remap ALL entries in the index to the chosen PDF. So you cannot use this for indexes that point to multiple PDF files. This will basically remap all entires in the index to point to a single PDF.

Here’s how to do this:

1: Open an index and press Edit Index

2: Press the downward v (in this picture to the right of Colorado)

3: Choose Link to new PDF and choose a PDF file to remap all entries in the index to.

Once you choose a new PDF, all of the index entries will point to the new PDF.

Utilities Window

Email Preferences

Allows you to email a backup of the unrealBook preferences file.

Backup All Support Files

Will allow you to backup a zip of the support files that unrealBook creates (minus the PDF files). These are all the support files unrealBook creates minus the PDF files. You can upload to dropbox, email or use Open in… (airdrop).

Back to Dropbox

Provided you have the time and enough space on Dropbox, this will upload all your files to Dropbox. unrealBook will attempt to upload each file one by one to Dropbox. Since this can take a long time, I recommend using a computer and doing a manual backup.

Airdrop Documents to Computer – (iPad Pro only or capable iPad), allows you to Airdrop the entire contents of unrealBook to your computer. This will be a full backup of files.

Reset Preferences To Defaults – This will reset the preferences of unrealBook including the password for restricting file sharing (if you have defined one in the settings->global->functions.

Convert All Old Files To New – Only needed if you have really old files from unrealBook and have updated from a really old iPad to iPad Pro.