iReal Book Editor (Legacy)

  • This is a legacy product and is no longer supported

A free Mac OS X companion app that will simplify the process of editing and inputing iReal b charts.

  • Requires at least Mac OS X 10.5 Leopard (For Mac OS X 10.4 Tiger and Windows use the Web Editor).
  • Send and receive songs and playlists to and from your iOS device via email.
  • Upload and download songs or playlists to and from the iReal b forums.
  • Save songs and playlists to your computer.
  • Supports: Copy/Paste, Undo and Printing.
  • No library songs are included as this is an editing tool only.
  • For detailed info see the manual below

Installation and Opening
Download the latest version of iReal Book Editor for Mac OS X.
Unzip the file and move the application to your Application folder.
Click on the application icon to open it.
When opening the iReal Book Editor for Mac you’ll see this:

The iReal Book Editor will also automatically open if you click on a song link in an email or a song link in the iReal Book Forums.

Customize the Toolbar
In the toolbar you’ll find the most commonly used functions. You can customize it to your liking by clicking on the Customize button.

Note: if the Customize icon is grayed out and not selectable, click anywhere in the song chart to reactivate it.

When opening the iReal Book Editor the default song form you see is a 16 bar AB form with a 4/4 time signature indication.
If you want to open a new song with a different song template press the ‘Add New Song’ button in the lower right corner:

or select the first item in the File menu (shortcut CMD-N):

or use the New Song button in the toolbar:

You’ll be presented with a panel where you can choose from the available templates:

You can start inputing chords by clicking on the desired location in the song chart (a blinking cursor indicates the current position) and typing the desired chord.
As you type, the chord will be displayed in the main input text field and also printed in the song view to the left.

When done press ‘return’ to move to the following cell.
Note: it’s not required to use capital letters for the root.

You can type the whole chord with the keyboard or you can use a combination of the keyboard and the buttons in the editor.

The ‘X’ buttons are used to remove the corresponding symbols.

Chords are by default of Normal size and wherever possible it’s recommended to use this size.
In some situations where many chords needs to be displayed close to each other it’s possible to select the Small size.
You’ll see a small red “S” appear in the current cursor location which means that from that position on all the chords will be displayed in a smaller font until a Normal size character (“N”) is encountered.
The red S and N characters will not be visible once exiting the editor. The N works in the same way of the S in that all chords will be displayed of normal size until an S is encountered.
Use the ‘X’ button to remove any S or N characters from the song chart at the cursor position.

Note: the red helper marks can be hidden in the View menu

Pressing the Symbols tab will reveal all the available symbols that can be added to the song chart.

To delete or replace a symbol press the corresponding button when to cursor is in the corresponding cell.

Note about Rehearsal Marks: Any given cell, in addition to one of the letters can also include one of: Segno, Coda or Fermata sign.
Note about Bar Lines: ‘Opening’ and ‘Closing’ indicate left and right position respectively, in relation to the current position of the cursor.
The Vertical spacers are used to shift the layout of the chord progression downwards of three different distances.
The END character is used for the Player to indicate where the playback should end during the last chorus.

Alternate Chords
Alternate chords are chords of smaller size positioned above the normal chords.
To insert alternate chords select the ‘Alternate Chords’ tab.

Inputing of alternate chords works exactly as with regular chords.

Select the Text tab to add some text to the song chart.
You can type the staff text in the text field or you can select one of the predefined rehearsal instructions that are understood by the Player.

Use the up and down arrows to change the location of the text in relation to the current cell.

Song Info
Selecting the last tab will give you access to where you can edit all the song info.
Composer: provide separate first name and last name. If the song has multiple composers, include only the last names separated by dashes in the last name field.
Style: type in your own style name or choose one of the existing ones.
Key Signature: when changing key signature you can choose between simply changing the indicated key signature or also transpose the song chart to the new key signature. To do the latter check the box next to ‘Also transpose chords’.

The iReal Book Editor will automatically create a playlist as you add more songs.

In the Playlist side panel you can see a list of all songs currently in the playlist.
From here you can also name the playlist itself, select one of the songs to be edited, sort the songs alphabetically, delete songs and add more songs.

Note: when saving, the whole playlist will always be saved and an .irb file will be created (.irb files can be opened exclusively by iReal Book Editor for Mac OS X).

Merging playlists
To merge two playlist it’s necessary that one of the playlists is available as a link either in an email or in the Forums.
Open the first playlist in iReal Book Editor and then go to your email or the forums and click on the link to open the second playlist.
You will be taken back to iReal Book Editor and the songs in the second playlist will be added to the original playlist.
You can now save it to your computer, send it via email or post it to the forums.

Transferring song charts and playlists
Once you’ve created or edited a song chart or a playlists it is useful to be able to send it to your iOS device, share it with other iReal Book users or to save it for backup purposes.
Using the normal Save function in the File menu will create an .irb file containing the whole current playlist, that can be opened exclusively by the Mac iReal Book Editor.

Sending via email
To send a song or a playlist to a iOS device, the easiest way is to email it (Apple Mail is the recommended email client).
Click on the Song to Device or Playlist to Device button in the toolbar or select the corresponding choice in the File menu:

An email with an attachment will open in Apple Mail ready to be sent.
The song or playlist in this email can be opened on an iOS device by opening the email in the Mail App and tapping on the song link or playlist attachment.
Assuming that the iOS device has iReal Book installed on it, it will automatically open and import the song/playlist.

This method can also be used to send a song/playlist to another user with a Mac and iReal Book Editor: open the email and click on the song link or the link in the playlist attachment and iReal Book Editor will automatically open (as long as it’s properly installed and updated to the latest version).

If you wan to send a song/playlist to a PC or a Mac not running iReal Book Editor the receiving party can use the Web Editor and open the song there. On the receiving end the user should right click on the song/playlist link in the email and copy the link to clipboard.
Open the Web Editor, paste the content of the clipboard in the appropriate box and click on Import.

If you are using a different email client or a web browser based client it’s possible to use the ‘Save Playlist to Clipboard’ or the ‘Save Selected Song to Clipboard’ function in the File menu.
The content of the clipboard can then be pasted into the body of an email and sent to an iOS device.
We don’t support this method as it sometimes doesn’t work with certain email clients and with long playlists.
If you’re set on using this method be prepared for some trials and errors.

A further option to email a single song is to create a PDF version of it and send it as an attachment.
Select the desired song and press choose Print. When the print dialog opens choose Mail PDF instead of actually printing.

Using the forums
The iReal Book Forums are an ideal place for downloading and sharing songs and playlists.
While navigating the forums you can simply click on a song link or playlist to have it open in iReal Book Editor (as long as it’s properly installed and updated to the latest version).

To post the song or playlist you’ve created in iReal Book Editor to the Forums, press the ‘Song to Forums’ or ‘Playlist to Forums’ button or choose the equivalent commands in the File menu:

You’ll be greeted by this message panel through which you can open the Forums in your default browser.

You’ll now need to log in to the Forums if you haven’t done so already (To be able to log in you’ll have to register as well) and follow these steps;
- Navigate to the desired forum and the appropriate thread where you want to add your song/playlist.
- Choose the appropriate category and the appropriate thread if one exists already, otherwise you’ll need to create a new thread. It’s recommended to insert songs into existing threads to help keep things organized.
- Press Post Reply (or New Thread in which case you’ll also need to provide an appropriate title for the thread).
- Paste the content of the clipboard in the body of the post.
- Add any comments if necessary.
- Click Submit Reply.

Copy, Paste and Edit
To select an area of the song currently being edited click and drag the mouse over that area (this currently only works by starting at the top of the desired area and dragging downwards).

You can now choose one of the following from the Edit menu:

Cut will remove the selected area from the song and shift the following remaining chords back to fill the cleared area. At the same time the content of the selected area has also been saved to the clipboard.
Copy will save the content of the selected area to the clipboard without affecting it.
Paste will copy the content of the clipboard into the song starting from where the cursor has been positioned.
Delete Content will clear the content of the selected area leaving all the cells empty.
Delete Beats will remove the selected area from the song and shift the following remaining chords back to fill the cleared area.

Note: both Delete Content and Delete Beats also work on individual cells just by positioning the cursor in a particular cell without the need to make a selection.

Note: to insert beats use the the Insert Beats command from the Edit menu (to insert bars, or whole lines, press Insert Beats multiple times).

Contextual menu
All the symbols available can also be accessed with a contextual menu by right clicking on the song:

It’s suggested to hide the red editor markers from the View menu before printing:

To print a song simply click on the Print button in the toolbar or select Print from the File menu: