Library Management Overview

The diagram below shows how the WorshipSong library is made up of multiple zip files, each containing a complete song's audio tracks and a text file telling WorshipSong how to use them.


If you have a song already prepared for use with WorshipSong Band (such as a song you purchased from our store), the "tracks.txt" file had already been prepared and included in the song's zip file. You just need to put it into your library.  Most track providers will supply you a download code.  This can be entered via the "+" button on the library page, and the song will download to your device.  The video below shows basic library management.


If your song is not already in our format, follow these 3 steps in to add it. If you don't need looping or chord charts, you can skip steps 2 and 3. This tutorial shows a fast process for accomplishing all steps using the WorshipSong app with built-in editor features on Windows and Mac.

Song Import Process

Step 1: Create the zip file with the song's tracks

  1. If the files are not already zipped, put all the song tracks in a single folder. You do not need to pan stereo tracks or the click track, nor do you need to convert the files to a compressed format. The importer automates this work for you. Zip up this folder by clicking on the folder and selecting Send To->Compressed Folder. Name the compressed folder to the name of the song.
  2. Drag the zip file onto WorshipSong Band
  3. A track importer window will be shown. Select the name for each track you want. Any tracks you name the same will be bounced to one stem.  You need to end up with 16 or fewer stems. Click convert.
  4. The file will be processed and a new 'Tracks.txt' file created in a new zip archive with the tracks. Use a BPM analyser such as MixMeister to get the tempo if you don't have it already. Any WAV files will be automatically converted during this process.
  5. The song should be in the library now. Open up the song and press the 'E' key. A text editor will open to view/edit the 'Tracks.txt' file. There is also a section editor available to edit the main song information such as tempo, key, name, and time signature,and the sections (markers). When you make edits using this editor, if will rewrite the relevant sections in the text file as you edit, as if you had typed the information into the text file. You still need to 'Save/Reload' to actually save edits to the zip file when the section editor is used
  6. A Save/Reload button appears to write the zip and reload the song as you make edits. If you make an edit that causes the app to crash, manually edit the file in the zip to fix it.
  7. Edit the header information to set the songs title, artist, writer, key, and tempo, in the text or using the section editor.
  8. You may copy this zip file to any additional devices running WorhipSong Band, or share the song using team sharing.

Step 2: Map out the song's sections

  1. If the song has no vocals, find a chord chart, recording or video to use as a reference to identify the song sections.
  2. The song's tempo as listed in the tracks.txt file should be accurate to the decimal digits (example: 82.5).  Most songs are an even tempo, but any tempo will work.
  3. In WorshipSong Band, load the song you are working on. Press the 'T' key to show beats instead of time on the mixer/chords page, and 'E' to open up the the editing features.
  4. Play the song. List the section name (Ct, Int, V1, V2,etc) in the tracks.txt file in the order they occur, or use the section editor if you prefer. If the section is repeated (ie, Ch), use the same name for each repeat.
  5. Section names should be short. Typically this convention works well and is used in our commercially offered tracks:
    • Ct (Count in)
    • Int (Intro)
    • V1 (Verse 1, etc)
    • PreCh (Pre chorus)
    • Ch (Chorus)
    • Br (Bridge)
    • Ins (Instrumental)
    • Out (Outro)
    • Tag (Tag)
  6. List the number of tempo beats for each section on the line after the section name, or type in the section editor. If you use the section editor, you need not reload the song as you map out the sections. Otherwise, use 'Save/Reload' to reload the zip file.
  7. Test the sections. Try looping to make sure the times are accurate.
  8. If the song is not using an even tempo, and the section starts do not occur on an even beat, list the section times in mm:ss.sss format to get them exactly right, using time signatures from markers in a DAW. The section editor shows both beats and times to aid you in doing this. Both are editable.
  9. If you don't need a chord chart, the song is now done and sections should loop.
  10. If the sections seem right but don't loop, your stems may be at 48000 HZ sample rate instead of 44100 HZ.  Reconvert to 44100 HZ in this case.

Step 3: Add the chord chart

  1. In the tracks.txt file. chord chart sections are added between the [Chords] and [End Chords] sections.
  2. Add a section in the file using each unique section name added in step 2.  Each section is of the form [Section name] followed by chords on even lines and lyrics on odd lines, with optional lyric breaks. The section ends when a new one begins or at [End Chords]
  3. Only one entry for each unique section is required (no duplicate sections needed). You can also use the same chart for multiple sections like this [Ch][Ch2]
  4. Specify the chord spacing by positioning the chords over the lyric where it belongs.
  5. If lines are too long for the lyric display or chord display, break the 2 lines into 4 lines.
  6. If the chord chart has words broken up with single dashes ('heav - ven'), change them double dashes ('heav-- en') so WorshipSong will remove them in the lyric display.
  7. If the chord section has too many lines for a particular lyric page, add lyric breaks with the number of beats after the section start such as:
    [Lyric Break] 16
  8. Lyric breaks are best added at logical points (ie, split 4 lyric lines into 2 separate lines)
  9. Reload the song. Press the 'L' key in WorshipSong to see a preview of the lyric display.
  10. Iterate and reload until the chord chart and lyrics display work as expected.

Optional Steps: Add Info and Branding

  1. Add a branding icon if desired. Use a 64x64 pixel bmp or tga image.
  2. Add a song description.
  3. Add a background for the song by adding a 1024x576 tga file named 'background.tga'. to the zip.

Follow Us