OnSong Manual
Latest Updates
The following are pages of the user manual that have been updated since OnSong 2026.4
- Inline FormattingInline formatting allows you to format words and phrases within your text content. You do this by wrapping the text with angle brackets, and then use line formatting syntax to determine the change in style.
- AuxDockThe AuxDock™ is a performance surface that slides up from the bottom of the screen and turns your device into a live music rig...
- Mixer WidgetThe mixer widget lets you place a user interface containing album artwork and a way to mix your tracks onto the screen. The mixer widget behaves like other widgets, letting you place in on your screen, interact with it, or configure settings.
- SettingsYou can change settings for the mixer widget as well as MultiTrack playback using this screen. Here's what you can do:
- SynesthesiaColor is how we see the world so it should come as no surprise that color can help us understand complex information, including music. Some musicians even experience color when hearing certain notes or chords...
- Audio Track ChooserThe audio track picker displays all tracks that match the current chord chart by name. In addition, this menu will display a custom track that you've picked...
- Choose Custom TrackTo link a custom audio track to your chord chart, you must first decide which library to pull from for playback. While these methods of accessing audio tracks are slightly different, they all include the ability to link a track just by tapping on it...
- Track EditorThe track editor is accessed by swiping from right to left over audio tracks and choosing the Edit button. This present you with editable fields. When you are finished making changes, tap on the Done button to save your changes...
- Tempo PickerThe tempo picker is displayed when a tempo is required to play the metronome, when tapping and holding on the metronome live bar button, or when settings the tempo using the Metadata Editor in the Song Editor...
- AnnotationsSometimes chords and lyrics are not enough to communicate how to play a song. In that case, the annotations menu can help. Tap on the additions icon in the menubar to access the annotations tab...
- WidgetsWidgets are self-contained user interfaces that you can place on your screen. This tab lets you toggle those widgets on and off in one place.
- Clip EditorOnce you have an image or PDF selected, or if you are editing an existing clip, you can view it in the clip editor...
- Customize Menubar ScreenThis screen lets you change the items that are contained in the menubar and their order. The list is organized into three sections:
- Google CastGoogle Cast lets you send OnSong to a Chromecast, Google TV, or other Cast receiver on your Wi-Fi network so your lyrics appear on the big screen, complete with motion backgrounds and live video...
- Quick PickTapping on a song title in the heads-up display area of the menubar will open the Quick Pick screen. This screen is designed to let you quickly find a song in a live scenario, preview, and add it to your existing set for viewing.
- Choose SetsThe sets tab lets you quickly see the sets in which a song belongs and also place a song in a set without going through the Sets tab. Let's take a look at how to create and pull sets all with one menu.
- ShareOnSong plays nice with others and that includes sharing! The unified share menu gives you an easy way to share your songs and sets for performance.
- Add PersonYou can manually add people to your sharing list with just an email address and optional name. Once a valid email address is entered, you can press the Done button in the upper right corner to add the person to your share people list.
- Edit TeamWhen you add or edit a team, the team editor screen appears. This let's you specify the following information for the team:
- ServersThe servers tab will display servers on the OnSong local network including yourself.
- Export MenuThe export menu lets you choose a location where exported content should be saved. The title reads Export File for a single file, or shows the number of files when you have more than one to export, such as Export 3 Files.
- Configure ColumnsThis screen allows you to customize columns to display when outputting song lists. Tap on a row to toggle the checkmark that indicates its visibility. You can also use the reordering handles to change the what order the columns appear including:
- TeamThe Team screen shares a set, a book, or the songs you selected with people on your team so they stay in sync. Choose Team in the Share Menu to open it...
- Import from DropboxIt's easy to import your song files from Dropbox. Dropbox is the easiest way to create, edit, and store your files on a computer, and then access them on your mobile device or any other device you own...
- Import using File SharingFile sharing is a way to move files on and off of your device when connected to a computer using the USB sync/charge cable...
- PreviewThe preview screen appears when you tap on the eye button next to the chart to preview it, or when you are not signed in. The preview screen is displayed full screen to estimate what it will look like if you import it into the OnSong® app.
- OnSong® DriveYour OnSong® Drive is created on and accessed via your OnSong® Account. It's a secure way to store files you use in OnSong...
- Browse FilesOnce you've selected a source from the source list, you are presented with files and folders. Tap on folders to navigate to more files.
- Multiselect ModeWhen you tap on the Select button (checkmark icon) in the upper right corner of the All Songs menu, you enter multiselect mode. This allows you to pick multiple items in the list at once and perform actions on your selection.
- Active SetsActive sets are your primary set lists. These should contain recent and upcoming sets to provide quick access to what you are playing next.
- Archived SetsArchived sets are sets that you have already played. This segment of the set list is not only used to store old sets for reference, but is also useful for sorting songs and song reporting.
- EditorSets allow you to perform songs for a specific event. To create a set, you tap on the + button in the set list to open the set editor. Here you can specify the following information about the set.
- Preferred KeysThis screen lets you pick keys you prefer for performance or for what’s playable for you. It opens as Choose Performance Keys or Choose Playable Keys, depending on which row you tapped in the set editor...
- FoldersFolders are used to organize your sets. For instance, you may want to keep track of all the sets you've played at a specific venue so that you don't play the same songs. You may also want to track your sets based on the bands in which you play...
- DiagramsThe diagram tab lets you configure how diagrams appear on your chord chart using the following settings.
- Dual ChordsThe dual chords tab lets you enable and configure secondary chords that appear next to the primary chords on the screen. This can be useful if you are sharing a chart with someone using a capo, or if you are learning a numbering system.
- Metadata DisplayThis screen lets you configure the types of metadata content to display. By default, the OnSong® app shows the artist under the title of the song. You can add additional metadata and choose the order in which it appears. This list includes:
- UnavailableWhen you import PDF or word processing files, OnSong can only display those files "as-is". When you open the Style Preferences Menu, the controls will be disabled and you'll have one of the following options.
- UtilitiesThe utilities menu provides access to this help screen, as well as other functions that are outside of the typical flow of OnSong. Here are the options available in this menu:
- Let's Get StartedIn order to use OnSong, you'll be prompted to set up an OnSong account. Any OnSong subscription is bound to your OnSong account allowing you to use it on a different device and to access web-based features.
- Switch AccountsWith OnSong, you could belong to more than one group, or be a member of a group while holding a personal account. This screen allows you to switch between account roles as well as showing you which groups you belong to and their subscription expiration.
- RestoreThe OnSong® App stores backups to OnSong® Cloud by default. When you first sign into a default library with your OnSong® Account, you'll be prompted to restore from backup. You can also restore from backup using this screen.
- Foot Pedal TriggersThe Pedals tab allows you to configure one or more foot pedals to trigger actions in OnSong.
- OnSong® AuxBoxThe OnSong® AuxBox is the complete solution for musicians looking to use the OnSong® app on stage. It features an audio interface as well as HDMI video output and USB ports that let you run the show all while charging your device...
- MIDI Settings MenuThe MIDI Settings screen gathers everything the OnSong® app does with MIDI into one place: the devices it connects to, the tempo it shares with them, the events it sends while you play, how it responds to messages arriving from elsewhere, and what it put
- System InformationThe system information screen provides information about your OnSong library, statistic and precise control over secondary screens.
- Energy ManagementUnlike other apps, OnSong will prevent the device screen from going to sleep during use. You can use these settings to modify how OnSong behaves and provides ways to conserve battery.
- User InterfaceUser interface settings let you control how you use the app.
- Document LayoutThese settings define how text-based charts are laid out on the virtual page.
- BridgeThis setting screen lets you determine how sections defined as bridges appear by default in the system.
- ChordsThis setting screen lets you determine how chords appear by default in the system.
- ChorusThis setting screen lets you determine how sections defined as choruses appear by default in the system.
- Font ListWhen setting text formatting, you can choose a font family to use to override default styles. You can choose from the following:
- HeaderThis setting screen lets you determine how the song title of the song appears by default in the system.
- InstructionsThis setting screen lets you determine how musical instructions appear by default in the system.
- LyricsThis setting screen lets you determine how lyrics of the song appear by default in the system.
- MetadataThis setting screen lets you determine how the metadata of the song appears by default in the system.
- MonospacedThis setting screen lets you determine how sections as tablature or other monospaced fonts appear by default in the system.
- Section LabelsThis setting screen lets you determine how section labels appear by default in the system.
- Text File HandlingWhen OnSong imports certain files, it may need to be given a hint to the file encoding or format. Text File Handling settings help OnSong know how to handle certain files it encounters.
- Metronome SettingsThe metronome in OnSong is capable allowing you to hear and see the beat. This screen shows common settings for the metronome as well as the ability to adjust other aspect.
- ClipsYou can set up default formatting options for clips. This includes the following attributes:
- Song EditorSong editor settings allow you to customize how the Song Editor looks and behaves. You can make the following modifications:
- Scrolling BehaviorThe scrolling behavior screen includes options also found in the Foot Pedals section, but duplicates them here since scrolling behavior is also used when tapping on the screen. This settings screen contains the following options:
- Search SettingsYou can choose to search settings by keyword which brings up a search interface on the right side of the search screen...
- Contact UsIf you require technical support or are experiencing an issue, please fill out the following field to ensure the best service from the OnSong support team.
- Chord InspectorThe chord inspector appears when a chord or chord diagram is tapped in the Song Viewer. This allows you to see various ways to place the chord on different instruments.
- 4-String BassDiagrams for bass guitars are rare since you typically only play one string at a time. OnSong provides chord diagrams for bass guitar for completeness and to help teach bass guitar to students.
- 5-String BassDiagrams for bass guitars are rare since you typically only play one string at a time. OnSong provides chord diagrams for bass guitar for completeness and to help teach bass guitar to students.
- BanjoThe banjo instrument displays chords using four strings. This is done with the standard banjo tuning of D G B D.
- GuitarThe default instrument selected for the chord inspector and diagrams is guitar. Guitar chord diagrams contain six strings tuned to the standard E A D G B E tuning.
- MandolinThe mandolin instrument displays chords using four strings. These strings are tuned to the standard mandolin tuning of G D A E.
- PianoThe piano instrument displays chord diagrams as miniature, two-octave versions of the piano keyboard. The keys to be played are highlighted in red.
- UkuleleThe ukulele instrument displays chords using four strings. This is done with the standard ukulele of G C E A.
- Context MenuThe context menu gives you more actions that can be performed on the underlying audio track including:
- SongsThe songs tab in the audio media library shows all songs contained in your library. Songs are indexed alphabetically by track name.
- Attachments MenuThe attachments menu gives you quick access to different versions of the selected song.
- PropertiesYou can choose to view the properties of the attachment to edit it. The screen is titled Edit Attachment. If you open the properties of a version, the screen is titled Edit Version and shows only the Name field.
- Compact ModeWhen using OnSong on iPhone, iPod Touch, or when running OnSong in a split screen, the song editor is altered displaying less menubar buttons while offering the same functionality. The menubar contains:
- OnSong® ChartsOnSong® Charts is a growing library of professionally transcribed chord charts you can search and import right inside OnSong — no more building every song from scratch...
- Set PickerThe set picker opens in its own window and allows you to browse and search for songs in your library to add to your set.
- View SongsTapping on a set will view the songs in the set.
- MomentsMoments let you add other events to your set list, turning it into a run sheet for event management...
- ChordsThe chords tab lets you transpose and capo chords as well as determine how those chords appear. It also lets you select an instrument for chord diagrams.
- Supported FilesOnSong can transpose chords found in text-based chord charts. Using a feature called ChordFlow™, we can also peer inside of PDF files and transpose and format chords in place.
- ChordsThe chord section determines the default behavior and interface options for the Style Preferences Menu Chords tab. You can make changes in the following sections:
- AdvancedThese are more advanced options that are not available within the menu but that alter how the renderer treats chords.
- FormattingThis section contains settings for formatting the chord.
- ClientsThe clients tab displays devices that are currently connected to your device.
- Choose KeyThe choose key menu lets you to pick a different key to set as metadata in the song's metadata. This will be the declared key of the song in which it is written.
- Pick SongsThe set picker gives you full access to your OnSong® library, letting you browse and search for songs all while queueing up songs to add to your set.
- ConsoleOnSong Console is a premium feature that gives you the ability to manage your OnSong library from a web browser on another computer. You can import and write chord charts to see a preview of the chord chart in real-time as you type...
- Choose PedalOnSong works with popular foot pedals. Tap on the title bar of the pedals action tab to jump to the setup screen for a supported foot pedal.
- Chord DiagramsChord diagram appear when you tap on a chord in the song viewer to open the Chord Inspector, or if you turn on chord diagrams to appear using the Style Preferences Menu. You can change how chord diagrams are drawn using these preferences.
- EnharmonicEnharmonic represents how sharps and flats are applied during transposition. By default, OnSong uses the enharmonic preference of the key that is being transposed into. The following preference can adjust how this is treated:
- Live Bar SettingsThe live bar contains four buttons by default. These buttons are arranged in a square in the lower right corner of the screen...
- Dual ChordsDual chords allow you to have two different styles of chords present on the same sheet. For instance, you could display both the transposed chords as well as the original all at one glance.
- PlatformsThe OnSong® app is available on multiple platforms. Click into each to learn more:
- AndroidFor years people have asked for OnSong for Android and now, it's a reality. You can install OnSong on your Android 9.0 or newer device from the Google Play Store.
- iOS/iPadOSOnSong originally launched in 2010 just one week after the first iPad went on sale. Ever since, it's been a hit with musicians around the world. Ever since we've been trying to make the perfect app for musicians...
- KindleAmazon Kindles are a great alternative to iPads on the stage since they feature good screens at a low cost. However they do make some engineering decisions that can affect live performances...
- Mac CatalystOur flagship OnSong app can be installed on your Mac laptop or desktop through the Mac App Store. You get the same great features of the mobile version of the app with a familiar interface but designed to fit into macOS. Requires macOS 11...
- Context MenuThe context menu provides access to actions that can be performed on selected attachments including:
- ExportThe export screen is used to export the selected song or set in popular file formats. Besides allowing you to choose the location and file format for export, this screen also allows you to choose output options...
- Song List ExtrasWhen printing a song list, the extras section is used to determine what columns should be outputted in the song list table. These columns are presented in the order they will appear in the song list table output...
- Action MenuThe menubar functions of the iPad version of the song editor are accessible in this menu. Tap the action button on the right side of the menubar to open it:
- Sorting SongsTapping on the sort button displays the Sort Songs By menu indicating ways you can sort your songs. The current sort method is highlighted with a checkmark and the sort direction is displayed at the bottom.
- Context MenuThe context menu lets you tap and hold or right-click on a book to perform additional actions such as:
- By TagChoosing a tag provides an experience similar to browsing by attribute. The screen is titled with the tag’s name, such as By Mood. You will see all the tag values that were entered for songs in this list along with a quantity to the right...
- Context MenuThe action menu can be accessed by tapping on the name of a set while in Editing Mode or by tapping and holding (iOS/iPadOS) or right-clicking (macOS) on the name of the set. This allows you to perform the following actions:
- Context MenuThe following actions can be performed on songs that are placed in the set.
- Add MomentThere are preset moments that you can add to your set. Choosing one of these options will automatically fill out the moment's title and icon and open the Moment Editor where you can set a color or duration for the moment.
- DocumentThe document tab lets you change the document settings for each song such as the low light mode, tint color, font, paper size, and margins.
- FormatThe Format tab lets you change the appearance of the song content.
- Tempo SettingsOnSong can send the current tempo of the song as a MIDI MSB/LSB control change, and it can follow a tempo sent the same way by another device...
- Send TempoWhen you configure the OnSong® app to Send Tempo as discrete MIDI commands, you may want to send those commands more than once. This screen lets you choose how many times to send the MIDI commands when the song is loaded.
- AdvancedThe debug section in settings is used to correct issues that may occur when using OnSong. The following are switches that inform OnSong to perform certain functions when it starts up...
- IntegrationsOnSong works with various services and software and you can configure these integrations in settings. ProPresenter You can connect to ProPresenter 7 through your local network to move between presentations, slides, and build playlists.
- DiagramsChord diagram appear when you tap on a chord in the song viewer to open the Chord Inspector, or if you turn on chord diagrams to appear using the Style Preferences Menu. You can change how chord diagrams are drawn using these preferences.