Release Notes

OnSong 1.987

OnSong 1.987 was released on June 30th, 2014. Here are the fixed issues, changes and additions in this release.


  • New! Motion Backgrounds

    OnSong can now use videos to display motion backgrounds when projecting lyrics. This works when directly connected via an HDMI or VGA cable, and even when wirelessly projecting lyrics with AirPlay.
    To learn more, watch our video tutorial.

  • New! Lyrics Projection Media Picker

    We are super-thrilled to add a new media picker in the external video menu when projecting lyrics. This now lets you toggle between multiple backgrounds from within OnSong. You can add backgrounds from your photo library using the "+" button, or use the web browser to navigate to a site where you can download media. This feature is not available on iOS 5.x due to performance constraints.

  • New! OnSong Shift

    Get maximum flexibility with your foot pedal setup. With OnSong Shift, you can create multiple "gears", each one with a different pedal configuration. Set up one gear for navigating and scrolling your songs, and another for sending messages to your team. To learn more, watch our video tutorial.

  • New! Team Messaging

    Using stage monitor mode or OnSong Connect, you can now send color-coded messages to your team in real-time. Access messages from the message bubble in the menubar. To learn more, watch our video tutorial.

  • New! Pagination and Page Scrolling

    You can now scroll text-based songs and PDF files by page using the new "Jump To Page" option in scrolling behavior. This means pressing a foot pedal or tapping the screen will jump to page 2, 3, etc. If you are in landscape orientation, OnSong will automatically scroll half pages instead. To learn more, watch our video tutorial.

  • New! Rebuilt Audio Playback with Crossfade

    We've seen a number of issues with audio playback and decided it was time to get things ready for more audio sources soon. We've updated the player and have thrown in the ability to crossfade between tracks. For a full overview of how to fade and crossfade tracks, watch our video tutorial.

  • New! Completely Redesigned Settings Screen

    We've brought order to the chaos in this release by organizing settings better. For a full overview of the new settings screen, watch our video tutorial.

  • New! Customizable Stage Monitor Displays

    You can now customize how stage monitor mode displays chord charts. Turn off capo for other members of you team, or turn on low light mode independently of the what's on the iPad screen. To configure, go into Utilities » Settings » External Video » Stage Monitor » Instrument Settings.

  • New! Better Planning Center Integration

    We've fixed some issues with PCO integration and added some great new features like the ability for OnSong to import chord charts written inside of Planning Center in addition to attachments. You can also show all plans from the plan list instead of just upcoming plans.

  • New! MIDI Song Select Events

    For users of the MIDI add-on, you can now send and receive Song Select commands to pick songs.

  • New! Create Page Breaks

    You can now set where you want a page break to occur for printing and exporting PDF files. Add four hyphens on a line ----, or use the ChordPro {np}, {npp}, {new_page}, or {new_physical_page} tags to set just where you want your song to break for printing.

  • New! WorshipReady.com Integration

    Import great OnSong-formatted charts into your library from your WorshipReady.com subscription.
    Sign up for a subscription today!

  • New! LTC Asaph Integration for French Users

    French users now have the option to import from the Asaph LTC content.


  • Updated the location of PageFlip Cicada and Firefly user manuals.


  • Changed the way lyrics projection works to allow gradients (clear to black fills) to be applied on top of color or background image or video. This resolves some inconsistencies reported in earlier builds.
  • Changed rendering of chords so that when they appear on a single line, no blank line would appear under and adjusted whitespace is used for more natural spacing.
  • Changed the ability to send messages to include the current screen and connected external displays.
  • Changed the viewer to place parenthetical text on the same line as bracketed chords if that's all that is contained in the line.
  • Changed the way the hiding menubar alert displays to reduce users simply dismissing the alert and left wondering what happened to their menubar.
  • Changed the MIDI action picker screen to allow MIDI to be used to send other MIDI commands or OnSong Messages.
  • Changed the iTunes Suggestions area of the app to only show song links.
  • Changed the icon that appears when "Play Only" is selected in settings.
  • Changed the color of the "Buy" button in the Foot Pedal screens to be more evident.
  • Changed OnSong Connect to start scrolling client devices when the server "flicks" the screen. This eliminates the delay associated with waiting for deceleration to end.
  • Changed OnSong Connect to allow metronome start/stop events to be transmitted. This is turned off by default in the OnSong Connect profiles on client devices. This does not handle network latency or mid-stream BPM or time signature changes.
  • Changed OnSong Connect to return cached versions of songs and sets to reduce database and processing time.


  • Fixed a crash condition when launching OnSong without proper Internet connection.
  • Fixed crash conditions when using OnSong Connect.
  • Fixed an issue where writing a new song, or changing the key of a song would not update the transposed key, resulting in the song being written in "F", but displaying "C" until transposed again.
  • Fixed an issue where disabling MIDI and restarting OnSong will cause the setting to not be maintained.
  • Fixed and issues where disabling MIDI should stop sections from being selected but was not.
  • Fixed a crash condition when importing from PCO when the key of the song is set.
  • Fixed an issue where switching time signatures would cause imported files to redrawing quickly, eventually causing a crash.
  • Fixed an issue in OnSong Connect where the autoscroll command was not being heard.
  • Fixed an issue in OnSong Connect where position notifications were being intercepted when autoscroll was running.
  • Fixed an issue in OnSong Connect that would cause connections to drop between devices.
  • Fixed an issue in OnSong Connect that would cause the server to not send messages to clients who were previously servers.
  • Fixed an issue where unarchiving a set when auto-archiving is turned on would not allow the set to be placed in the active list. Sets can now be forced to be unarchived even when auto-archiving is turned on.
  • Fixed an issue where typing in a chord definition with "sus" would not allow that chord definition to be used due to "sus" being replaced with "sus4".
  • Fixed an issue where duplicating a song in a set and then changing the key in one would reflect that change in the other.
  • Fixed and issue where text of a footer tag in ChordPro formats would appear in the header and footer of the page.
  • Fixed an issue where placing a > character in front of a section header would be interpreted as a highlighted line, causing the section label to disappear.
  • Fixed an issue when importing sets from RWTC would cause a crash.
  • Fixed and issue where if a backing track is not specifically specified, the song will not automatically play.
  • Fixed an issue where changing the key in the song editor of an imported file such as PDF would not update the key in the song list.
  • Fixed an issue where chord diagrams above lyrics are offset from the chord position because of the chord diagram being centered within the declared frame.
  • Fixed an issue where external files were not appearing in PCO or stage monitor mode due to a change in the display preferences configuration for this new feature.
  • Fixed an issue when editing the songs in the set list (rearranging, removing, etc) where removing a set would cause the "Done" button to appear as "Edit" and tapping "Cancel" would not make the song reappear as it should.
  • Fixed an issue with zoom behavior when using the new renderer due to how we capture multi-touch events.
  • Fixed an issue with editing sticky notes when using the new renderer that is caused by the multi-touch events being captured though the sticky note.
  • Fixed an issue where content could not be viewed under the conversion toolbar in the song editor before the keyboard is displayed.
  • Fixed an issue where tapping on a different slide background color would cause a crash due to changes in how lyrics projection information is handled.
  • Fixed an issue where AirTurn foot pedals (or any foot pedals) will stop working when an "action menu" appears due to a change in iOS 7 where the device steals the focus of the keyboard entry and does not return it properly.
  • Fixed an issue where scrolling to the bottom of a page with chord diagrams turned on, and then turning them off would cause a blank screen because of the sudden change in page size.
  • Fixed an issue with black screens that appear when importing sets from PCO.
  • Fixed an issue where you can't choose a variable action when manually adding a MIDI event.
  • Fixed an issue where names of files are being truncated in Dropbox when a period is encountered.
  • Fixed an issue where sending custom messages would require two taps instead of one to send.
  • Fixed an issue where Internet charts that are surrounded by sot/eot tags would cause the song to not be imported.
  • Fixed an issue where importing a set from PCO would cause navigation issues.
  • Fixed an issue where updating the title and byline of a song would not update alphabetic indexes.
  • Fixed numerous issues when moving in and out of blackout mode in lyrics projection.
  • Fixed issues in lyrics projection with switching between gradients and background images.
  • Fixed issues with lyrics projection when using hot corners to go to next/previous section.
  • Fixed performance issues with lyrics projection.
  • Fixed an issue where restrictions were not being picked properly in the metadata editor.
  • Fixed an issue where picking "None" from metadata restrictions was really like picking "Not Set" and not allowing previous rights to be removed.
  • Fixed an issue where turning on "Project" restrictions was not being respected, allowing songs to be projected.
  • Fixed an issue where turning on "Export" restrictions was not being respected when syncing to Dropbox.
  • Fixed an issue which prevented changing key multiple times in a song.
  • Fixed an issue where sorting songs by artist, songs with no artist would not be listed resulting in blank lists.
  • Fixed an issue where folders in iTunes file sharing import were appearing as OpenSong files.
  • Fixed an issue where switching to sets can cause a black screen due to conflicting animations.
  • Fixed an issue where OnSong crashes when loading more than one DOCX file. This is done by disabling render ahead/behind which can be set explicitly in Settings » Debug » Render Ahead/Behind.
  • Fixed an issue with auto show/hide menubar that caused the menu to close at the wrong times.
  • Fixed an issue where ChordPro comments that contained colons but also had trailing spaces were being detected as section labels.
  • Fixed an issue where OnSong would not detect chord lines that contained parenthesis.
  • Fixed the duplicate term for "Unarchive Sets" and "Delete Sets" in Swedish.
  • Fixed an issue where the English localization information was not being loaded for settings.
  • Fixed an issue where users can't enter a maj-nth chord into the tablature editor.
  • Fixed an issue where picking an action from the MIDI screen in low light mode would not show any options.
  • Fixed an issue when importing songs into the "pick songs' screen where the screen would go to the wrong place in the set menu.
  • Fixed an issue where editing a song in the song editor causes it to appear at the top of the songs list when sorted by Added.
  • Fixed how restrictions are set when importing from RWTC.
  • Fixed an issue with selecting albums in the iTunes suggestion area of the playback menu.
  • Fixed an issue with the Playback menu size when iTunes suggestions is turned off.
  • Fixed an issue where songs are being removed from books if the book metatag is present and saved in the song editor.
  • Fixed an issue where upload restrictions were not being respected, allowing restricted content to be uploaded to Dropbox, etc.
  • Fixed an issue where the Update, Overwrite, Skip screen would appear when importing from SongSelect repeatedly, causing the song to never be able to be imported.
  • Fixed an issue that prevents sets from being renamed once they were created.
  • Fixed the delay that occurs when creating a new set from scratch in iOS 7 when the keyboard is not displayed.
  • Fixed issues related to having MIDI enabled when also trying to use hot corners due to section selection overriding the hot corner hit area.
  • Fixed an issue with song reporting where usage-based tracking was non-operational and not showing daily reports.
  • Fixed a crash condition that can occur if SysEx is selected but no value is set.
  • Fixed an issue where tacking the chord picker/builder menu in the song editor would cause all other popover menus to not be able to be closed. This was fixed by turning off the tacked status if another menu is selected.
  • Fixed an issue that caused a crash when a song's last played time was displayed for a song still being reported.
  • Fixed an issue when importing songs when picking songs for a set where the navigation controller is sent back to the beginning instead of the pick song list.
  • Fixed an issue where OnSong Connect clients do not receive commands because another one is being processed, causing a disconnect between the server and client which results in the device disconnecting.