HarmonyBuilder (Basic)

The easy-to-use music notation software for composing and sharing music scores.

User Manual
                      

 

                 Table of Contents

General Description
Installation
       1) Java
       2) Free Version
Key Features
      1) Four Parts
      2) Five Navigation Modes
      3) Two Scrolling Modes
      4) Mouse-free Composing and Editing
Getting Started
Additional Features
       1) The Text Tool
       2) The Line Tool
       3) Undo/Redo Actions
       4) Inserting Chords
       5) Voice Muting
       6) Choosing Instruments
       7) Printing
Playback
Navigation Modes
      1) Note Mode
      2) Snapshot Mode
      3) Snapshot Mode (p/w)
      4) Step Mode
      5) Fixed Position Mode
Rhythm
Repeated Notes
Alteration Format
Enharmonic Equivalents
Adding Empty Bars
Scrolling While Composing
Open and Save Functionalities
       1) Local Hard Disk
       2) Harmonic Sequences Archive
       3) HarmonyHub Forum
       4) Auto-Save

Sharing the Score
Keyboard Controls and Shortcuts
Tool Tips

 

General Description                                                                                                                                    

HarmonyBuilder (Basic) is a music score editor designed to maximize the ease and speed of composing and editing, while at the same time structuring the compositional process into 4 independent parts. It is ideal for the exploration of complex harmonies and rhythms, particularly in chorale format, throughout the 26 major and minor keys, utilizing any combination of binary and ternary rhythms.

It employs intuitive controls which can be easily understood, with helpful pop-up Tool Tip windows for every command on the panel.

Installation

1) Java

HarmonyBuilder (Basic) will operate on any system that supports Java, including Windows and Macintosh.

In order to function, HarmonyBuilder (Basic) requires that the Java Runtime Environment (otherwise known as "Java") be installed on the computer. This is a free download from www.java.com.

To find out if your computer has Java installed or not, go to
https://www.musilogic.com/harmonyhubforum/checkjava.jsp.

If it is not present, please carry out the installation. This will also enable the correct functioning of the HarmonyHub Forum and Archive.

If, following the installation and launch of HarmonyBuilder (Basic), you do not hear any sounds, it is possible that, during the installation of Java on your system, the soundbank was not correctly installed in the Java > Audio folder inside the Program Files. To correct this, simply click on the button below:

 

Get Soundbank


2) Free Demo Version

A free demo version of HarmonyBuilder (Basic) can be downloaded and installed from www.harmonybuilder.com. This can be used to play native HarmonyBuilder (Basic) files (.HAB format), but will not have some of the functionalities of the activated version, as seen by the greyed-out sections of the File menu show below:

                                                         

To enable all the menu items, a Unique Activation Key must be purchased from www.harmonybuilder.com, and pasted into the Activate an Upgrade window.

Top

Key Features

1) Four Parts:

Why does HarmonyBuilder (Basic) deal with at most 4 parts? First, because the essence of all tonal music compositions can be expressed both melodically and harmonically within the confines of 4 parts. Second, because this architectural decision gives HarmonyBuilder (Basic) the advantage of presenting the user with a score in which the 4 parts - Soprano, Alto, Tenor and Bass - have already been configured for easy and fast manipulation. With just one click, rests can be converted to notes or chords; notes can be readily split into two or three smaller notes, or melded into larger notes, or simply reconverted to rests.

2) Five Navigation Modes

HarmonyBuilder (Basic) provides 5 independent navigation modes, apart from the classic “playback” mode at a selected tempo. Every note that is heard is visually reinforced with orange coloring. In the 2 "snapshot" modes, this coloration feature highlights the subtle harmonies of inner parts, providing the user with a valuable analysis tool. Furthermore, the 4 parts are all completely independent, with separate volume and instrument controls.

3) Two Scrolling Modes

Cinematic Scrolling: Innovative auto-scrolling technology enables the active notes to automatically and smoothly scroll to the center of the screen, exactly where the user wants them. This frees the user from awkward clicking and dragging operations, because the notes being heard and edited are always at center stage!

Line-flip Scrolling: This is the classic viewing method whereby as the cursor reaches the far right of the screen, a fresh line of music is instantly replaced on the screen. This provides a stationary score, as an alternative to the moving score of cinematic scrolling, and is also faster to use during speed editing.

4) Mouse-free Composing and Editing

Great effort has been made to reduce mouse-clicking to a minimum. Most of the commands for note navigation, editing, and playback can be executed with simple keyboard shortcuts or with the four arrow keys, and will allow for extensive “mouse-free” editing.

Top

Additional Features

1) The Text Tool: You can enable the Text Tool by checking the box under Settings > Enable Text Tool. The text box is opened by double-clicking the desired location in the score. Then, the user can type some text. By clicking the mouse again (anywhere), the text will be committed to the canvas.

Text can be dragged
by clicking once on the text when the "hand" appears. This will make a little red arrow appear to the left of the text. The text is now enabled for "clicking & dragging". Click away from the text to disable "click & drag".

To further edit text that is already committed to the canvas, double-click on the text when the "hand" appears. This will open a Text Editor in the top-left corner of the screen. This will enable retyping, as well as changing the font, size and type face.

2) The Line Tool: You can enable the Line Tool by checking the box under Settings > Enable Line Tool.You can draw straight lines across any portion of the canvas, by clicking & dragging. Once a line has been drawn, you can select it by clicking on it when the "hand" appears (a little red arrow appears at one end of the line), and drag it by clicking again and dragging to the desired position.

3) Undo/Redo Actions: Every action performed during the composition or editing process can be  
undone and redone, up to a total of  1,000 actions, using the Undo and Redo buttons.

4) Inserting Chords: By default, a Tonic chord, containing the Root, 5th, 3rd  and Root above, is entered when Chord > Add is pressed. These chord elements can later be edited by the user.

5) Voice Muting : Each of the 4 voices - Soprano, Alto, Tenor and Bass - can be muted, using the adjacent check box.  Also, any volume can be assigned to each of the 4 parts, with a range of 0 - 127.

6) Choosing Instruments: Any of the 128 General Midi instruments can be assigned to each of the 4 parts.

7) Printing: A printable version of the score can be compiled, by selecting File > Print. Note: Printing of checker errors is only available in the Educational and Professional versions.

Top

Getting Started

Launch your copy of HarmonyBuilder (Basic) from the Start > Programs index or the Desktop Icon. The canvas will appear with only the treble and bass clefs visible. You must now begin entering the necessary parameters for your composition.

Step 1: Choose a Key Signature;
Step 2: Choose a Time Signature;
Step 3: Insert some empty bars. Each time you press Empty Bar > Add, one full bar will be inserted;
Step 4: Move to any rest in the empty bars, by using the arrow keys, or by clicking on it with the mouse;
Step 5: Insert a chord at this position, by clicking on Chord > Add;
Step 6: Navigate to any part of the score using the 4 arrow keys (slow navigation) or the Shift + right/left arrow (fast navigation);
Step 7: Convert any rest to a note, and any note to a rest, by clicking on the Delete/Insert button;
Step 8: Nudge any note into the desired position by using the Shift + up/down arrow keys;
Step 9: Split any note into two (or three) equal parts, or meld two (or three) equal notes together, using the Split and Meld buttons;
Step 10: Play the composition by pressing the Play button. Stop it by pressing the button again. Note: playback starts from the location of the square cursor.

The figure below summarizes the sequence of steps for creating a composition:

 

Top

Playback

When the Play button is pressed, playback always starts from the position of the square cursor. The notes that are playing will turn orange, and the score will start scrolling. You can chose between either Line-Flip or Cinematic scroll modes. Playback can be stopped at any time, by pressing the Stop button (the Play button turns into a Stop button when the score is playing). Note that the square cursor will remain positioned on the starting note during playback. When the Play button is re-pressed after stopping, playback will start from the location of the square cursor.

The location of the square cursor can be changed by any of the following methods:

  1. Use the the right/left arrow keys on the computer keyboard;
  2. Click on a note with the mouse;
  3. Use the Shift + right/left arrow keys to scroll rapidly to a new position;
  4. Use the Go To button to jump to the selected bar number;
  5. Use the Home or End buttons to jump to the beginning or the end of the composition;

Once the position of the square cursor is set , the same portion of music can easily be replayed for analysis, without having to reset the start position each time.

Top

Navigation Modes

Note: ensure that the Midi On checkbox is selected.

The 4 Arrow Keys on your computer keyboard     can be used to navigate to all the notes and rests in the score. The aural and visual feedback during navigation can be one of four options.

Option 1: Note mode: In this mode, the square cursor (which surrounds the selected note) will play the selected note as well as turn it orange. The left/right arrow keys will move the square cursor to adjacent notes within the selected part, while the up/down arrow keys will move the square cursor to the adjacent parts.

                                    
                                                                      Note mode

 

Option 2: Snapshot mode: In this mode, the actively sounding notes at any instance in time can be heard and seen in orange. This enables the user to evaluate the interaction of later notes with previous notes whose sound holds over to the time when the later note is played. The left/right arrow keys will move the square cursor backwards or forwards one chord at a time. The up/down arrow keys will move the square cursor within the elements of the chord.

                                        
                                                                     Snapshot mode

 

 

Option 3: Snapshot (p/w) mode (p/w means “part-wise”): The aural and visual feedback is the same as the Snapshot mode, but there is a restriction on the way the square cursor moves through the score. The left/right arrow keys will move the square cursor to adjacent notes within the selected part, while the up/down arrow keys will move the square cursor to the adjacent parts.

Option 4: Step mode: In this mode, only the notes within the vertical line selected by the square cursor will be heard. The square cursor’s navigation is identical to Snapshot mode, which is:  the left/right arrow keys will move the square cursor backwards or forwards one chord at a time. The up/down arrow keys will move the square cursor within the elements of the chord (all the chord notes will be heard at each movement of the square cursor).

 

                                       
                                                                         Step mode

Option 5: Fixed Position mode: This is a fast scrolling method, allowing the user to move rapidly through the music, one step at a time, without having to wait for the continuous scroll to complete. To scroll, press Shift + right/left arrow keys. The square cursor will remain in a fixed position throughout the scroll.

 
Fixed Position mode

Top

Rhythm

When Chord > Add is pressed:

  • For Time Signature = 3/2, the basic note duration is the half note.
  • For Time Signatures = 2/4, 3/4, 4/4 and 6/4, the basic note duration is the quarter note.
  • For Time Signature = 6/8, the basic note duration is the eighth note

Therefore, to obtain note durations that are different from the basic note duration for the chosen Time Signature, use the Split and Meld buttons.

Splitting creates shorter notes, and melding creates longer notes. Please note that melding will only occur between notes of equal pitch and duration.

Split > Binary: this will convert the selected note into two notes with half the duration of the selected note.
Meld > Binary: this will convert the selected note into one note with twice the duration of the selected note, provided there is a note of equal pitch and duration on the right of the selected note.

Note: melding is not possible between notes of equal pitch and duration in separate triplets: a pop-up will suggest using the Tie/Untie button instead.

Split > Ternary: this will convert the selected note into three notes with one third the duration of the selected note.
Meld > Ternary: this function can only be applied to the first note of a triplet. It will convert the selected note into one note with three times the duration of the selected note, provided there are two notes of equal  pitch and duration on the right of the selected note.

The following diagrams show the different levels of division obtainable with binary and ternary splitting:

                                                    

 

 

                      
                                                                                              
Top

Repeated Notes

Any two neighboring notes, provided they have identical pitches, can be tied together. They do not need to have the same durations. The result is to extend the duration of the first note by the duration value of the second note.

Any tied notes can be untied by simply re-pressing the Tie/UnTie button.

Alteration Format

Any selected note can be nudged up or down the chromatic scale by using the Shift + up/down arrow keys. The note alteration symbols have been chosen to reflect the most commonly used chord extensions on a dominant chord. For example, in the Key of C major, we have the following extensions of a G7 chord:

                            
                           G = root
                        Ab = flat ninth
                            A = ninth
                          A# = sharp ninth
                            B = third
                            C = fourth
                          Db = flat fifth
                            D = fifth
                         D# = sharp fifth
                            E = thirteenth
                            F = seventh
                          F# = major seventh

 while in the Key of C minor, we have the following extensions of the G7 chord:


                           G = root
                         Ab = flat ninth
                            A = ninth
                          A# = sharp ninth
                            B = third
                             C = fourth
                          Db = flat fifth
                            D = fifth
                          Eb = flat thirteenth
                            E = thirteenth
                            F = seventh
                          F# = major seventh
Top

Enharmonic Equivalents

If notes need to be named differently from the way they are written automatically by the program, use the Enharmonic Equivalent  drop-down menu (Enharmonic Equiv.), in the Selected Note panel, and select any of the alternative name options for the selected note.

Adding Empty Bars

The first time Empty Bar > Add is pressed, a pop-up will appear, asking “Do you want to add Pick-Up Bar?” The pick-up bar allows for an empty bar to be entered before the numbered bars begin:

Each time the Empty Bar > Add button is clicked once, an extra bar, populated with rests, is added to the composition. The keyboard shortcut for adding an empty bar is Ctrl + Space Bar.

Top

 Scrolling while composing

There are four ways of moving to different parts of the score during the process of composition:

(1) Navigate through the notes using the left/right arrow keys. The score will automatically scroll left or right, bringing the square cursor to the center of the screen each time it approaches the edge of the screen. This is ideal for the initial stages of composition, where rests are being converted to chords.
 
(2) Hold down the Shift + left/right arrow keys. This will scroll the score very rapidly to any location.

(3) Select a note, then press the Play button. Auto-scrolling will start when the notes being played reach the far right of the screen. When the score has reached the desired place, press the Stop button. Click on a new note to set a new playback start position. The scrolling speed will adjust automatically to the Tempo setting, which can be set between 30 and 240 b.p.m. (beats per minute).

(4) Press the Home key on your computer keyboard to jump the score instantly to the first bar, or press the End key to jump the score instantly to the last bar.

(5) Select a bar number in the Go To menu, then press "Go To". The score will jump to the desired bar.

Note: the Home, End and Go To features are sometimes useful to ensure that scrolling takes place correctly, after extensive repositioning of the square cursor may lead to scrolling being de-synchronized.

Top

"Open" and "Save" Functionalities

1) Local Hard Disk: Any file having the .HAB format (HarmonyBuilder format) can be opened with HarmonyBuilder (Demo). If the application is activated, it will also save to the local hard disk, both in .HAB format and MIDI format (provided Settings > Create Midi File is checked)

2) Harmonic Sequences Archive: If the application is activated, it will save save to and from the Harmonic Sequences Archive, a free, public, music score archive, hosted by www.harmonyhub.com .

3) HarmonyHub Forum: If the application is activated, it will confer Super User status to the email address used to purchase the Activation Key. If this email is used to login to the HarmonyHub Forum, and provided you use the same computer on which HarmonyBuilder was activated, the Player and Editor applets inside the Forum will also allow saving forum compositions to the local hard dirk, or importing compositions from the local hard disk to the Forum

4) Auto-Save: If the application is activated, it will be possible to enable auto-saving. To do so, go to Settings > Auto-Save, and check the "enable auto-saving" check box. The default location of the "autosaved_backup.HAB" file is shown in the Auto-Save Settings panel. This can be re-set to another location, if desired. The backup file does NOT overwrite the file saved manually by the user using the File > Save (To Disk) menu.

The intervals at which the auto-save is performed can be changed manually. By default, it is every 2 minutes.


 

Sharing the Score:

An important feature of HarmonyBuilder (Basic) is its capability to easily share compositions over the internet. There are 3 ways this can be done:

1) Once a composition has been completed, it can be saved to a free public archive, hosted by www.harmonyhub.com, where anyone can see the composition link and click it to see and play the score. This is ideal for providing a showcase for a composition, as well as creating a permanent archive of the score. The upload date is automatically included, providing documentary evidence of its publication date.

2) Compositions can be uploaded to a password-protected private database, accessible over the Internet, but only to those people who know the access password. This is ideal for teachers, students, or workgroups who wish to share compositions among themselves, but not with the wider world. Contact support@musilogic.com for subscription details.

3) Compositions can be shared with a friend (or group of friends) by e-mail. From the File menu, the Email This Score item can be selected, and this will open a form which allows the user to enter up to 10 e-mail addresses. Once the form is sent, the composition is stored on the server for no less than 7 days, and the recipients of the email will then be able to click on a dedicated hyperlink that opens the composition in their browser. This is ideal for sharing musical ideas between two or more people via email. This service is free.

Top

Keyboard Controls and Shortcuts

A few commands can only be executed by the keyboard, and have not been included on screen panel, in order to keep it uncluttered. Here is a comprehensive list:

                                                  Commands only available on keyboard:

Command Function
Up arrow Moves square cursor up one part (Note mode and Snapshot (p/w) mode only)
Down arrow Moves square cursor down one part (Note mode and Snapshot (p/w) mode only)
Right arrow Moves square cursor to next note (according to navigation mode)
Left arrow Moves square cursor to previous note (according to navigation mode)
Shift + Right arrow Scrolls the square cursor rapidly to the right
Shift + left arrow Scrolls the square cursor rapidly to the left

 

Most of the commands present as buttons or menus on the screen have a keyboard shortcut counterpart. Here is a comprehensive list:

                                      Commands available on screen and also as a keyboard shortcut:

Command Shortcut
Shift + up arrow Nudges note one step up
Shift + down arrow Nudges note one step down
Enter Start/Stop
Delete/Insert note Ctrl + Del
Chord > Remove Ctrl + Shift + Del (only available in Builder panel)
Split (Binary) Ctrl + S (binary radio button selected) OR Ctrl + 2
Meld (Binary) Ctrl + M (binary radio button selected) OR Ctrl + Shift + 2
Split (Ternary) Ctrl + S (ternary radio button selected) OR Ctrl + 3
Meld (Ternary) Ctrl + M (ternary radio button selected) OR Ctrl + Shift + 3
Tie/Untie Ctrl + T
Enharmonic Equivalent Ctrl + E
Empty Bar > Add Ctrl + Space bar
Chord > Add Ctrl + A
File Save F2
Undo Ctrl + Z
Redo Ctrl + Y
Ctrl + I Zoom In
Ctrl + O Zoom Out

Top

Tool Tips

As the mouse is moved over each of the control buttons or drop menus on the control panel, a text box will appear.This explains the function of the button, and sometimes offers a suggestion of how to apply it.                                

                                                       Full list of control panel Tool Tips:

Button/Menu
Tool Tip
New
Start a new composition
Open (from Disk)
Open a HarmonyBuilder file (with .HAB extension) residing on your local hard drive
Open (from Archive)
Open a HarmonyBuilder file residing on the online public HarmonyHub Archive
Save (to Disk)
Save your composition to your local hard drive
Save As
Save your composition with a different name
Save (to Archive)
Save your composition to the online public HarmonyHub Archive. Note: you cannot delete a composition from the Archive once saved. Should you wish to remove a file, please write to admin@harmonyhub.com.
Print
Open a printable version of the score
Email This Score
E-mail a link to this composition. It will be available on the server for 7 days
Activate an Upgrade
Copy and Paste an Activation key obtained from the "Upgrade to" menu.
Exit
Close application. WARNING! All unsaved work will be lost!
Key
Select Key Signature
Time Sig.
Select Time Signature
Empty Bar > Add
Add one empty bar containing only rests
Chord > Add
Convert 4 rests in the selected location to notes. Select a rest first.
Undo
Undo performed actions (one action per click)
Redo
Redo performed actions (one action per click)
Instrument
Select a different Instrument
Volume
Select Instrument volume
Note
Navigate through single notes
Snapshot
Navigate through single chords
Snapshot (p/w)
Navigate through single chords (part-wise)
Step
Listen to composition one step at a time
Play
Play composition from the selected note
Tempo
Set the Tempo for the composition
Split
Split the selected note in either binary or ternary mode
Meld
Meld the selected note with the next note (binary mode) or next two notes (ternary mode).
N.B. All notes must be of equal pitch and duration
Binary
Set the mode for Split and Meld to Binary
Ternary
Set the mode for Split and Meld to Ternary
Tie/Untie
Tie/Untie the selected note with the next note
Del/Ins
Delete/Insert: convert the selected note to a rest, and vice-versa
Enharm. Equiv.
Change the way the selected note is written
Go To
Jump to the selected bar number
Home
Jump to the first chord in the composition
End
Jump to the last chord in the composition


Top

 

 

©2008 Musilogic, Inc.