This page contains a documentation of SongBeamers lyrics file format (*.sng).
I own the official format documentation. If you have questions to the content below or if you are interested in additional features, offered by the format, than don't hesitate to ask me - M²j.
File format documentation
This is the draft for the documentation of SongBeamers song file format.
Each song is stored in it’s own *.sng file. A SNG file is a plain text file with no specific character coding (I’ve seen ISO-8859-x as well as UTF-8 and UTF-16 files).
A SNG file starts with the properties of the song. They are encoded in
#property=value pairs. The values dosen’t contain a line break, so
there is exactly one property each line. All properties seem to be
Here is a list with the most important properties:
|Author||string||name of the lyrics author||
|Melody||string||name of componist||
|Translation||string||name of translation author||
|NatCopyright||string||national copyright information||
|Rights||string||additional rights (e.g. for translated lyrics)||
|AddCopyrightInfo||string||additional copyright information||
|Editor||string||name of editing program||
|Bible||string||bible passage the text is based on||
|Categories||string||categories the song is about||
|QuickFind||string||quick find string like STTN for “Shout to the North”||
|Comment||string||arbitrary comment||#Comment=correct slide 4|
|Comments||string||Comment encoded with base64||
|Chords||string||Chords encoded with base64. The decoded string is an index of chord placement seperated by "\r", like this: ",,\r"||
|Key||string||mus. key of the song||
|VerseOrder||string||order of the song parts||
|Songbook||string||also written: SongBook||
|LangCount||integer||number of translations in song file||
|Lang||string||language of the song||
|BackgroundImage||string||Path to background relative to image folder. Observed file types: JPEG, PNG, BMP, WMV, AVI||
|Font||string||font for lyrics||
|FontSize||integer||font size for lyrics||
|Version||integer||format version? 99.9% it’s 3 otherwise 2||
After the propertied there are the lyrics.
Each verse is introduced by a line just containing three hyphens
The next line contains either the name of the following block(s) (e.g Vers 2, Bridge, Refrain 1) or if there is no name it starts with the the lyrics them self.
If there are more than one languages the alternative lyrics are following on each other line by line. For two languages each second line belongs to the same language. So, if you have English, Spanish and German lyric in one song and there should be a empty line, you have to insert three empty lines.
SongBeamer allows also to use some HTML-Tags inside its lyrics. Here is what SongBeamers manual is writing regarding to this:
HTML-Tags are a powerful functions for the advanced user. Use them for very specific requirements, that you cannot do otherwise.
|<h:x>…</h>||Font height in pixels (1 to 1024)|
|<wordwrap>…</wordwrap>||Automatic word wrap|
|<linespacing:x.x>||Linespacing 1.0 = Default|
|<->||Hyphen - Used when two guitar chords are too close together|
The tags </h> </s> </c> can also be used like </h:x>. x is the new value. That way you do not need to write an additional closing tag.
This is a example for inline translation. The song as well as the translation are public domain.
#LangCount=2 #Title=Nearer My God To Thee #Editor=SongBeamer 1.11f #Version=3 #Format=F/K// #TitleFormat=U #TitleLang2=Näher mein Gott zu Dir #OTitle=Nearer my God to Thee #Author=Sarah Full Adams (1805-1848) #Translation=Erhard Friedrich Wunderlich (1830-1895) #Melody=Lowell Mason (1792-1872) #VerseOrder=Strophe 1,Strophe 2,Strophe 3,Strophe 4,Strophe 5 --- Strophe 1 Nearerm my God, to Thee, nearer to Thee! Näher, mein Gott, zu dir, näher zu dir. E'en though it be a cross that raiseth me. Drückt mich auch Kummer hier, drohet man mir, still al my song shall be, nearermy God to Thee, soll doch trotz Kreutz und Pein dies meine Losung sein: nearer my God to Thee, nerer to Thee. Näher, mein Gott, zu dir, näher zu dir! --- Strophe 2 Though like the wanderer, The sun gone down, Bricht mir, wie Jakob, dort Nacht auch herein, darkness be overme, my rest a stone. find ich zu Ruheort nur einen Stein, Yet in my dreams I'd nearer, my God,to Thee, ist auch im Traume hier mein Sehen für und für: nearer, my God, to Thee, nearer to Thee. Näher, mein Gott, zu dir, näher zu dir! --- Strophe 3 There let the way appear, steps unto heaven: Geht auch die schmale Bahn aufwärts gar steil, All that thou sendest me, in mercy given: führt sie doch himmelan zu unserem Heil. Angels to brockon me nearer, my God, to Thee, Engel, so licht und schön, winken aus selgen Höhn: nearer, my God, to Thee, nearer to Thee! Näher, mein Gott, zu dir, näher zu dir! --- Strophe 4 Then with my walking thoughts bringht with thy praise, Ist dann die Nacht vorbei, leuchtet die Sonn, out of my stony griefs Bethel I'll raise. weih ich mich dir aufs neue vor deinem Thron. So by my woes to be nearer, my God, to Thee, Baue mein Bethel dir und jauchz mit Freuden hier: nearer, my God, to thee, nearer to Thee! Näher, mein Gott, zu dir, näher zu dir! --- Strophe 5 Or if on joyful wing, cleaving the sky, sun, moon Ist mir auch ganz verhüllt dein Weg allhier, and stars forgot, upward I fly, wird nur mein Wunsch erfüllt: näher zu dir! still all my song shall be, nearer, my God, to thee, Schließt dann mein Pilgerlauf, schwing ich mich freudig auf: nearer, my God, to thee, nearer to Thee! Näher, mein Gott, zu dir, näher zu dir!
- A SongBeamer developer published a couple of years ago Delphi sample code1 to write SongBeamer files.
- Lyricue2, a free lyric projection software written in Perl, also supports SongBeamer import3.