Metadata

Metatags be a way t' provide information about a song and be expressed in a metadata section, savvy? Metadata be expressed in th' first section o' th' song before th' first blank line or until no more metatags be encountered. Metatags be name/value pairs where th' name be on th' left and value on th' right separated by a colon. Only one metatag can appear per line. Arrr, please reference th' ChordPro File Format fer details on how t' express metadata in th' ChordPro format.

OnSong automatically assigns th' first line o' a text file as th' title o' th' song if it be not in th' metatag format. In addition, th' second line be considered th' artist/byline o' th' song unless a metatag be defined. Th' followin' be an example o' a typical song metadata section that sets th' title and artist as th' first and second lines as well as th' key and tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Metadata Tags

Th' followin' tags be supported by OnSong:

• Title: Th' title o' th' song. This can also be expressed on th' first line o' th' song content.
• Artist: Th' artist name or any other byline information. This can also be expressed on th' second line o' th' song content. 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: 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
• TransposedKey: Th' desired key that th' song should be played in which can be different from th' key in which th' song be written. - alphabetic, e.g. Bb or Em
• In: be a pseudonym fer th' transposed key metadata tag.
• Capo: Th' capo t' set as number o' frets. This be typically a positive integer (1 through 11) but can also be set t' a negative integer. - 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 as well.
• 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.
• 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: Th' copyright information o' th' song. This will appear at th' bottom o' th' chord chart and lyrics projection.
• CCLI: Th' CCLI number o' th' song. This will appear at th' bottom o' th' chord chart and lyrics projection.
• Restrictions: These be restrictions that prevent certain actions from takin' place within a song. See Restrictions fer details on settin' restrictions fer yer song.
• Pitch: Th' note or notes t' play when usin' th' Pitch Pipe feature. This be defined as a space-separated list o' notes with optional octaves. - e.g. A3 C#4 E5
• Subdivision: or Beat: lets ye choose th' subdivision fer th' song. This can be a value includin': whole, half, quarter, eighth, shuffle, or sixteenth. Alternately ye can use a whole number such as 1, 2, 4, 8, or 16.
• Transpose: Th' number o' half steps t' transpose th' song. This be used mid-song t' modulate th' song up or down and adapts with th' key set in transposition sliders. This number must be a positive or negative integer.
• Tuning: Th' instrument tunin' t' assign t' th' song. These be specific t' instrument and only guitar be currently supported with these values: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G, or Open E.
• Scene: Th' scene t' be played when th' song be loaded. This can be set by enterin' th' name o' th' scene after th' colon.

Inline Tags

Some tags can be used within a song t' effect th' transposition mid-song. These include:

• Capo: can be used t' apply a capo mid-song, modulatin' th' song down t' provide chords t' play with th' capo applied. Ye can adjust th' modulation direction in Capo Settings. This be typically a positive integer (1 through 11) but can also be set t' a negative integer t' remove a previous capo. - numeric
• Key: t' set th' key explicitly in th' song. If ye surround th' value with brackets when usin' bracketed chords, th' resultin' key will be transposed as well. - alphabetic, e.g. Bb or Em
• Transpose: transposes th' song th' desired number o' half steps. This be a positive or negative integer. Fer instance, use 2 or +2 t' transpose th' song up a whole step, or use -3 t' transpose down three half steps. - numeric

Section Tags

Some tags can be used t' provide information about each section o' song. These include:

• MIDI: Th' MIDI commands t' send when th' section be selected. See MIDI Syntax fer how t' express MIDI commands as text in OnSong.
• Scene: Th' scene t' be played when th' section be selected. This can be set by enterin' th' name o' th' scene after th' colon.

Note: Metatags be not case sensitive