ChordPro

Th' ChordPro file format be a common format used in other software applications. OnSong understands this format natively. OnSong recognizes files with th' followin' file extensions: .chordpro, .chopro, .cho, .crd, .pro

Th' ChordPro format allows fer song information t' be expressed in tags delineated by curly braces. This information can be logically divided into metadata tags and inline tags.

Metadata Tags

These be ChordPro tags that ye would use in th' metadata portion o' th' song. In th' followin' tags, three dots (...) represent th' text ye supply, which goes between th' colon and th' closin' curly brace. Fer example:

{title: Amazing Grace}
{key: G}

OnSong supports th' followin' ChordPro tags:

• {title: ...} or {t: ...} Th' title o' th' song.
• {subtitle: ...}, {st: ...} or {su: ...} Th' artist name or any other byline information. Ye can specify multiple artists by separatin' names with a semi-colon. - Kim Walker-Smith; Chris Quilala
• {album: ...} Th' name o' th' album where th' song be located.
• {artist: ...} or {a: ...} Th' artist name or any other byline information. Ye can specify multiple artists by separatin' names with a semi-colon. - Kim Walker-Smith; Chris Quilala
• {author: ...} Th' name o' th' person who created th' chord chart. This be displayed at th' bottom o' th' chord chart and in lyrics projection.
• {key: ...} or {k: ...} or {ok: ...} Th' key o' th' song written as a key with enharmonic preference and an optional "m" t' indicate minor. - alphabetic, e.g. Bb or Em
• {capo: ...} Th' capo t' set as number o' frets - numeric
• {tempo: ...} Th' beats per minute (BPM) - numeric
• {time: ...} Th' time signature - numeric beat over bar e.g. 3/4
• {duration: ...} Th' song length fer autoscroll - seconds or mm:ss
• {book: ...} Th' name o' th' book or books t' place th' song into. This be a comma-delimited list o' book names into which th' song will be placed. If th' book does not exist, it will be automatically created.
• {number: ...} Th' number o' th' song - numeric, use fer hymns, years, etc. Ye can sort songs by th' number fer reference.
• {flow: ...} Th' arrangement o' sections - list o' section labels. See Flow fer details on arrangin' th' flow o' a song.
• {midi: ...} Th' MIDI commands t' send when th' song be viewed. See MIDI Syntax fer how t' express MIDI commands as text in OnSong.
• {midi-index: ...} Th' MIDI commands that will trigger this song t' be opened in th' Song Viewer. See MIDI Syntax fer how t' express MIDI commands as text in OnSong.
• {pitch: ...} Th' notes t' play when usin' th' Pitch Pipe feature.
• {keywords: ...} or {topic: ...} Th' list o' tags t' use with topic search. See Topics fer more information on browsin' by topic.
• {copyright: ...} or {footer: ...} or {f: ...} Specifies copyright footer text t' appear at th' bottom o' th' page or lyrics projection.
• {ccli: ...} Th' CCLI number o' th' song.
• {restrictions: ...} Th' rights management fer th' song's comma-delimited list o' restrictions. See Restrictions fer details on settin' restrictions fer yer song.
• {composer: ...} Th' individuals who wrote th' music t' th' song. This list should be separated with semi-colons fer separate values.
• {lyricist: ...} Th' individuals who wrote th' lyrics o' th' song. This list should be separated with semi-colons fer separate values.

Inline Tags

These tags be used within th' content o' th' song and can be used t' either define sections or t' format parts o' th' song.

• {define: ...} be used t' define custom chord diagrams. See Definin' Chords fer more information.
• {comment: ...} or {c: ...} Defines a comment and appears as a musical instruction.
• {comment_bold: ...} or {cb: ...} Defines text t' appear in bold.
• {comment_italic: ...} or {ci: ...} Defines text t' appear as italic.
• {guitar_comment: ...} or {gc: ...} Defines a comment that appears as a musical instruction.
• {start_of_verse: ..} or {sov} Declares th' start o' a verse section with an optional section label.
• {end_of_verse} or {eov} Declares th' end o' a verse section.
• {start_of_chorus: ...} or {soc} Declares th' start o' a chorus section with an optional section label.
• {end_of_chorus} or {eoc} Declares th' end o' a chorus section.
• {start_of_bridge: ...} or {sob} Declares th' start o' a bridge section with an optional section label.
• {end_of_bridge} or {eob} Declares th' end o' a bridge section.
• {start_of_part: ..} or {sop} Declares th' start o' a part with an optional section label.
• {end_of_part} or {eop} Declares th' end o' a part.
• {start_of_tab} or {sot} Declares th' start o' tablature which OnSong renders in a monospaced font.
• {end_of_tab} or {eot} Declares th' end o' a tablature section.
• {new_page} or {np} This be used t' declare a new page.
• {new_physical_page} or {npp} This be used t' declare a new page.

Formattin' Tags

Th' followin' tags be used t' define th' default font and size fer lyrics and chords in th' chord chart.

• {textsize: ...} Defines th' size o' th' lyrics as a numeric value in points.
• {textfont: ...} Defines th' name o' th' font t' use fer lyrics. Must be supported on th' platform.
• {chordsize: ...} Defines th' size o' th' chords as a numeric value in points.
• {chordfont: ...} Defines th' name o' th' font t' use fer chords. Must be supported on th' platform.

Supported File Extensions

Th' ChordPro file format be unique in that it be a commonly agreed upon syntax, but not a standard format. This means that various vendors can implement it in different ways and with different file extensions. OnSong supports th' followin' file extensions when importin' ChordPro-formatted files:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm