Attachments Menu

Th' attachments menu gives ye quick access t' different versions o' th' selected song, savvy?

Viewin' Attachments

Attachments be listed in two sections, matey:

Text

Th' text section contains text-based chord charts. Fer example, a downloaded ChordPro file be displayed in th' OnSong^® app's text-based renderer which provides th' most powerful features o' th' app like transposition, formattin', lyrics projection, chord detection, an' more. Arrr!

Attachments

This section contains other file formats like PDF or Word. These be typically viewed "as-is" in a compatible viewer. Fer example, ye could have multiple PDF files that change their format or which instrument th' orchestration be designed fer.

Each row shows th' file type, key, capo, an' file size. Versions o' an attachment be listed right below it with a version icon, an' show their own key an' capo.

Tappin' on an attachment will immediately view that attachment in th' song viewer an' make that th' default attachment fer th' song. If ye tap a text version that has no lyrics an' th' song has a PDF, OnSong first pulls th' lyrics from th' PDF's text while a spinner shows in th' row, an' then selects th' text version. This be controlled by th' Convert PDF File Automatically option in Song Viewer settings.

Edit Chords an' Lyrics

When ye have a text-based chart selected, ye can tap on th' Edit Chords an' Lyrics button at th' bottom t' open th' Song Editor. This button will read Edit Song Metadata when ye be viewin' a non-text attachment. Both access th' song editor t' change th' underlying text an' metadata o' th' song.

Add Attachment

Ye can use th' + button in th' upper right t' open th' Import Menu t' add additional attachments t' th' song, Ahoy!

Context Menu

Ye can tap an' hold (iOS/iPadOS) or right-click (macOS) t' view a context menu o' options on an attachment in th' list. This will display differently dependin' on if ye have selected a text-based attachment, or a file-based attachment an' if th' current attachment be selected. This provides access t' more advanced features like extractin' text an' convertin' files into PDF, an' such.

Settings

Ye can tap on th' wrench icon in th' upper-left corner t' access song viewer settings directly, ye scallywag!