Melodie Professional Edition

User Documentation

version 1.0


System Requirements

Installation

Installing Melodie is pretty straight-forward. Double-click the setup package to begin the install process. If you do not have the .NET Framework version 4.0 installed already, the setup package will attempt to download and install it. You can also download and install the .NET framework 4.0 from the Microsoft download site.

Getting Started

Projector

Melodie works by allowing you to control what is being projected from your laptop or PC in real-time. While song lyrics are being projected on a screen, you can search the database for the next song or queue up a bible verse to follow. For this to work, your computer or laptop must first be setup correctly. To setup your computer for dual-screen projection please do the following.

Set up your projector (or secondary output device) as an extended desktop. To do this, go into you operating system’s display configuration (often found in the control panel) and select the secondary device and click the “Extend my Windows desktop onto this monitor” option. See figures below:

Windows XP Windows 7
Windows XP extended Desktop Windows 7

Go ahead and power up Melodie. Provided the output devices have been setup correctly, your primary monitor should now display the Melodie  “Control Panel”, and the secondary monitor (monitor 2, or the projector) should be completely blank or may have a blue or black background gradient.

The Control Panel

The Control Panel is where the Melodie operator controls what and when things are projected. This section will enumerate the various functions of the control panel.

  1. The tab delimited control panel allows you to easily transition between the Song and Bible look-up sections.
  2. Quick song look-up will instantly search your song database as you type. The multi-threaded searching algorithm as been tuned for high-speed song lookup. Priority is given to song-numbers, followed by song titles and the first lines of songs. And lastly, if Melodie cannot find anything within those criteria, it will automatically start searching within the actual text of a song. So, if you only know a few lines of a song, Melodie can find it. Pressing [enter] when a list is displayed will automatically load the first song from the list ("quick-load").
  3. The sortable grid is dynamically generated as you type. Click on either the "Title" column, or "# column to sort. Clicking on an item in the grid will instantly open a preview of the song in the yellow "Preview" section below. Double clicking will load the song. Three (3) icons are provided on the grid for convenience:
    1. Click this is another way to load a song.
    2. This will add the a song to your playlist
    3. The edit icon will open the song up for editing.
  4. The option "show results as I type" is on by default. If you find that your computer's performance cannot handle the demands of instant searching your can turn this option off. The other option "Search song tags only" will tell force the searching mechanism to only look at the song tags field of songs. As you build up your song database you want to differentiate songs based on tags. You might want to mark songs that focus on key words, like "holiness" or "faith" for instance. Then, if you need to quickly find all of your "faith" songs, just turn this option on and type the word "faith". You can modify tags from the Song Edit screen,
  5. The Preview screen is a text block that is keyed into several controls on Melodie to instantly display the contents of things you click. For instance, if you have five items on you playlist and click on an item, the contents will display here.
  6. The shutter section controls the on/off status of the main projector screen. Clicking Show / Hide will turn On / Off lyrics and/or bible verses on your main screen. The Fade button is similar to Show / Hide but will slowly fade out your screen. The status of the shutter is shown as a monitor icon.
    1. This icon indicates the shutter is ON.
    2. This icon indicates the shutter is OFF
  7. The scrolling mechanism for Melodie Pro uses a Direct X-based WPF framework to provide smooth scrolling of text on screen. Click the Scroll button to turn on this feature to "scroll" your song lyrics up. The slider allows you to finely adjust the speed of scrolling. You can use a wheel mouse for even better control and/or use the "scroll-faster", "scroll-slower" shortcut keys (F2 and F1) . The current scroll speed is noted on the button status section. Click Scroll again to turn off scrolling.
  8. If you can loaded a playlist (see item 12) The Back and Next here will allow you to load the next item on your list (or traverse back on your list). The status bar on the very bottom of the window will indicate the current item you are on in your playlist.
  9. The Song Edit/New buttons will allow you to Add or Edit a song in the database. The Edit button is enabled whenever a song is loaded. If you find a typo in a song currently being displayed, clicking edit, fixing it, and then clicking the save button will instantly fix the mistake on screen: allowing you to make very quick and subtle corrections.
  10. The Content Preview is the primary means to maneuver a song as it's being displayed. Clicking on a stanza will cause Melodie to jump to that stanza. Clicking on a line number will make jump directly to that line.
  11. The Projection View is real-time look at what's being displayed live on screen. The projection screen will automatically scale based on your secondary output's current resolution. (When using a video-loop as you background, video playback is turned off in preview for performance).
  12. The Playlist: In the event that you know beforehand all the songs that want to display in a session, you may use the playlist feature to load your list of songs. The icons in the look-up tabs (song/bible) allow you to add songs or bible verses to the playlist. You can also save and load a playlist from a file. Use the down, up arrows and delete icon to arrange items in the playlist.  Clicking on an item on the playlist will cause it to show on the Preview section (item 5); double-clicking will load the song. Typing in the small text box below the playlist allows you to quickly enter songs into the playlist.
  13. The Display history is a log of all items that have been loaded during the session. Click the clear button the clear this list. The list is automatically cleared every time Melodie is closed.

The Bible Tab

Clicking on the Bible tab will  reveal controls for bible display. There are two ways to  display bible contents on screen:

  1. Type the Bible Book and reference into the text box. A preview will appear as you type; pressing enter will load the reference.
  2. Or, select the Bible book and chapter from the drop down and press enter to load.

Using the text box to look up a bible passage is a faster method of bible retrieval. By  using bible book abbreviations, Melodie will automatically fill in the book name as you type. Click the icon for a quick reference of abbreviations.

3. Use the search bar to quickly find a phrase or word within the entire bible. Clicking on a result will show it's preview, and double clicking will load the reference.

The default bible version can be set in the settings form on Melodie. Melodie supports Open Bible Standard(XMM) formats. There are several different bible versions available online. The software comes built in with a conversion tool to convert an XMM formatted file into something Melodie can use.

  • This icon will add a bible reference to the playlist;
  • This icon is another way to load up a reference.

When typing in a verse use this format: [Bible Book] [chapter] [verse] e.g.: "John 1 1". Use a space as a delimiter. Melodie will also accept ":" and ";" as chapter/verse delimiters. For books that begin with a number, delimiter the number also by a space: e.g.. to open the first chapter second verse from the first book of John, you would simply type: "1 John 1 2", and the press enter.

Adding/Editing Songs

Clicking on the "Edit" button on the Control Panel while a song is loaded will open the Song Edit screen. A similar form will open if you click the "New" button, allowing you to start entering in  new song..

There are three required fields for every song, all others are optional. The required fields are:
  1. Song Title
  2. Song Number
  3. And, the text or "body" of the Song

The icon is the "tag" field. Use this field to identify tag words to aid in searching.

You can use Melodie "markup" to identify chorus blocks of a song and to make certain words bold. Marking a stanza "chorus" will italicize the text when displayed on-screen. To use markup, simply highlight the text to mark and click either the "Bold" or "chorus" button. Clicking on "Preview" will load the text to the pane on the right with the markups rendered. Use two line-breaks to denote new stanzas and one line-break to force Melodie to break on a line.

Song Manager

The Song Manager can be loaded by clicking on Edit from the top menu and clicking on "Song Manager." This form provides a mechanism to quickly manage your song database and also offers a bulk import option to import song data.
  • The red Delete All button can be used to completely wipe your song database (use with care).
  • The grid will display the titles and numbers of all songs in the database. Use the Filter textbox to limit what's being displayed.
  • Double click an item to Edit a song or click the edit icon .
  • The trash icon can be used to delete a song.

Bulk Import

Melodie has a mechanism to bulk import songs. To use this, click on the "template file" link which will open up a folder of MS Excel files. Click either the .xlsx or .xls file and use the column headers as guides to create a spreadsheet file with all the songs you would like to import. Save your file, then click the Browse button, locate your file, and click the Load button to import. Required field in your excel file are just "SongTitle" and "SongText". If you do not provide a Song number one will automatically be generated. (Melodie requires SongNumbers to be unique.)

Options and Settings

Many aspects of Melodie can be customized/adjusted to your specific needs. To enter the settings form, click on "Edit" then "Options" from the top menu.

Melodie offers 4 different background choices:

  1. Solid Color : a simple straight  color setting. You can choose from your computer's entire spectrum of color.
  2. Gradient Color: a blended color option, that starts on one color and slowly transitions to another (horizontally or vertically).
  3. Image: any background image, tiled, stretched or fitted.
  4. Video Loop: a video clip that will be automatically repeated as a dynamic background (any windows video media file).
The fonts section allows you to choose the size and color of both the body and header text items on screen. The "header" refers to the reference (e.g.: Genesis 1:1) when displaying a bible passage. Songs do not have headers.

If need to move the text on screen over by certain amount, the margins sections allows you to make those adjustments. You can either shift just the text over by a certain amount of pixels and/or the entire canvas.

Other options include setting the default bible version, as well as the song database file that Melodie reads from (in the event you have more than one).

Keyboard Shortcuts

Melodie offers the following keyboard shortcuts to use in lieu of the mouse. Employing shortcuts can make Melodie even easier to use.

Importing Songs from Melodie Classic

Melodie Pro uses a different database engine for searching and looking up songs then previous versions of Melodie original. You cannot use Melodie Classic song database files natively, however, Melodie Pro has a built in upgrade tool to convert your classic Melodie song database file into the new format. Simply click on "File" and then "Import Songs from Melodie Classic" to launch the upgrade utility.

Auto-Updates

We are constantly finding ways to improve Melodie Pro. Melodie Pro has a built in utility to check for updates automatically (provided you have an active internet connection, and you are running an registered version of the software). If a new version is available, a notification will be displayed on the lower status bar. You can also force Melodie to check for updates by clicking on Help/Check for Updates. IT IS IMPORTANT TO FIRST BACK UP YOUR SONG FILE PRIOR TO INSTALLING AN UPDATE. You can back up you file by clicking on "File/Backup Song File".

Purchasing Melodie Professional

If you a running an evaluation version of Melodie and would like to purchase it, please click Help and "Buy Now / Register". Once you have purchased a copy of Melodie online, a product key will be emailed to you. Simply paste that product key into the textbox to activate.

Help / Contact Info

Visit Dynamic Gate for more information about Melodie.
For other questions and concerns please contact: DynamicGate@gmail.com.