Adding a New Song to WorshipSong Band


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.

LibraryMgmt2

If you have a song already prepared for use with WorshipSong Band (such as a song you purchased from our store or Praisecharts), 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.  See the Library Management section at this link for how to move songs into the library. 

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.

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

1) 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 toconvert the files to MP3.  The importer automates this work for you.  Make sure only the tracks are in this folder.  Name each file according to the standard naming scheme as follows, leaving the original file extension.  All track names are optional.  If stems are supplied, they will be put into this standard order below.  If other names are used, they will appear before the vocal tracks at the end.

   - Click. If not supplied, WSB's built in metronome will be used.
   - Cue. If not supplied, WSB's automatic cues will be available
   - Drums
   - Perc
   - Bass
   - RG
   - EG (can be multiple,like EG1, EG2, etc)
   - AG
   - LG
   - Keys
   - Piano
   - Synth
   - Strings
   - Pad
   - BGV
   - Vocal

2) 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.
3) Drag the zip file onto WorshipSong Band
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.
6) Edit the header information to set the songs title, artist, writer, key, and tempo, in the text or using the section editor.
7) Delete any unwanted tracks, and reorder/rename the tracks section if the automatic ordering or naming did not work as expected.  Remove the click from the list of tracks (if present) if you want to use WorshipSong's built-in metronome instead.
8) You may copy this zip file to any additional devices running WorhipSong Band.

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).
3) In WorshipSong Band, load the song you are working on.  Press the 'T' key to show beats instead of time, and 'E' to load 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.

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.  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.

 

 

 

 

 

 

 

 

 

©worshipsong 2016