The Harmonia Window

Create a new document in the Harmonia app by selecting New Document in the File menu. The main features of the Harmonia window are briefly identified below; consult the online documentation for detailed descriptions of the various buttons and editors.

1. Content: Click this button to access course content delivered via the Harmonia Cloud. Select your course from the pulldown menu in the popup Assignment Browser. Click on a triangle to expand a topic and then select the Read, Try, or Do buttons to open a file.

2. Grade: (only visible in student mode, and when gradable content is in the document): Click Grade to submit and grade an assignment document. The grade report is automatically uploaded to the course.

3. Document pulldown menu: Click here to view a list of currently open documents. A checkmark next to a document name indicates which document is currently in view.

   

4. Playback Transport: Use the playback buttons to play, fast-forward and reverse, change the volume, and alter the tempo. For the latter, either type in the desired tempo in the text box or click and hold on the dial and drag your cursor horizontally to adjust the tempo incrementally.

   

5. Cloud Sign In: Your computer must be on the network to sign into the cloud. Signing in enables teachers to access enhanced application features such as the ability to create lessons, assignments, and practices. Students sign in to access and complete their posted assignments available in their course menu. If you are connected to the Harmonia Cloud, your name will appear in blue inside the Sign In box.

   

6. User Mode Icons: Teachers can toggle between teacher (mortarboard icon) and student (student-group icon) modes to create and edit documents as a teacher and then view and test them as a student user.

   
   
   

7. Controls Icon: Click the gear-shaped Controls icon to display or hide an Edit Panel in the sidebar on the right side of the window. Depending on what is selected in the document, various Edit panels may be displayed. There are panels for Page Setup, Music (including Notation, Analysis, and Assessment panels), Text (word processing), Multiple Choice, Image, Streaming Audio or Video, and Score Generators. Edit Panels may also be displayed or hidden by selecting Show/Hide Edit Panel in the View menu.

   
   
   

After creating a blank document, teachers can add a variety of content to create interactive, multimedia documents such as the one shown directly below. Page content can include text, multiple-choice questions, musical scores, images, and Audio/Video streaming. Music scores added to a page can also be converted into composition or analysis assignments.

The content components visible on this page are:

1. Text boxes. These can contain stylized text and music theory symbols.
2. Audio and video streaming. Click to play within the app.
3. Embedded png or jpeg images. These can be resized and aligned right, left, or center on the page.
4. Context-appropriate editors for the selected item on the page.
5. Music scores with automatic analysis. These can be easily turned into analysis and composition exercises.
6. Gradable Multiple-choice question and answers.

Harmonia Menu Commands

The Harmonia menu bar displays a series of menus containing global application commands.

Note that certain Menu options and commands are only visible when in Teacher mode (top menu bar) or Student mode (bottom menu bar).

Harmonia App Commands

About Harmonia: Select this command to open a document showing Harmonia's version number and release information. Please be sure to include the version number in any bug report.

Preferences…: Select this command to configure startup and multimedia settings. In the Start Up Window group, choose from a variety of options for starting Harmonia. Under the Multimedia group, select how you’d like to experience audio and video streaming.

Services: connect to your computer’s Services Preferences.

Hide Harmonia: Hide the Harmonia window.

Hide Others: Hide all application windows except for the Harmonia window.

Show All: Show all previously hidden application windows.

Quit Harmonia: A popup window will appear asking users to save any unsaved/ungraded work before quitting the application.

File Menu Commands

New Document: Creates a new document window. This command is not visible in Student mode.

Open Document...: Opens a document file stored on the computer. This command is not visible in Student mode.

Open Recent▸Submenu containing the most recently opened documents. This command is not visible in Student mode.

Import MusicXml…: Imports a MusicXml score so that it can be added to documents, and automatically analyzed. This command is not visible in Student mode.

Close Document: Closes the most recently opened document, but the Harmonia window—and any additional open documents—remains open.

Close Window: Closes the Harmonia window and all open documents.

Save: Saves the current file. This command is not visible in Student mode..

Save As...: Saves the current file under a new name. This command is not visible in Student mode.

Export...: Saves a graded document as a .har file. Students can export a graded file, but only teachers can open them. This is only needed if a network interruption occurs after signing in; a student can still submit graded assignments to a course instructor. This command is not visible in Teacher mode.

Upload: Manually attempts to upload the document to the cloud course. This command is only needed if a network interruption occurs after an assignment is graded. Select this command to try to send the file again. This command is not visible in Teacher mode.

Sign In: Use this command to sign in to the Harmonia Cloud. Alternatively, you can also sign in by clicking the Sign in button at the upper right corner of the Harmonia window.

Sign Out: Use this command to sign out of the Harmonia Cloud. Alternatively, you can also sign out by clicking the Sign in button at the upper right corner of the Harmonia window and select Sign Out.

Page Setup…: Use this command to access the Page Setup Editor. Change Page size and orientation, margins, and color effects. Learn more here. This command is not visible in Student mode.

Edit Menu Commands

Undo: Undoes the last edit command.

Redo: Redoes the last undo.

Cut: Deletes the current selection from the document and adds it to the clipboard.

Copy: Copies the current selection to the clipboard.

Paste: Inserts copied material into the document.

View Menu Commands

Content Browser Style▸: Select from Drop down or Left panel; this option displays the Assignment browser in a drop-down menu in the center of the window or in a panel on the left.

Show Edit Panel: Display the Edit Panel for what is currently selected in the document. Edit Panels include Page Setup, Music (including Notation, Analysis, and Assessment panels), Text (word processing), Multiple Choice, Image, Streaming Audio or Video, and Score Generators. Users may also hide/display panels by clicking the gear Control Icon under the Sign In button.

Show Assignment Browser: Hide or show the Assignment Browser. Users may also hide or show the Assignment Browser by selecting the Content Icon on the upper-left side of the window.

Zoom▸: Change zoom factor as desired.

• Zoom In: Zoom in view on current document.
• Zoom Out: Zoom out view on current document.
• Actual Size: Change zoom factor to default document size.
• Fit Width: Change zoom factor to fit the page width.
• Fit Page: Change zoom factor to fit the page.

Show Notifications: Shows any Harmonia notifications.

Show Welcome Page: This command shows the Welcome Page with instructions for how to get started. This startup page automatically displays each time you start the Harmonia app. To turn this feature off, unclick the Show Welcome Page under Settings in the Harmonia menu.

Insert Menu Commands

The Insert menu is only visible with a teacher account. Use this menu to add content to a Harmonia document. Learn more about how to add content here.

Choose Score…: Select this command to add a Bach chorale or imported score to a document. In the pop-up box, select Bach Chorales in the pulldown menu and select from the 371 harmonized Bach chorales in Harmonia’s in-app database. Search by number, title, key, or meter. Double-click on a chorale to add it to the page. To select an imported score, first import the score and then choose it from the Imported pulldown menu. Double click a title to add the score to the page. Learn more about adding a score imported in MusicXml here.

Score Generators▸: Click on this command to add a score using Harmonia’s in-app Score Generators. Select from any of the generators listed below:

• SATB Generator
• Species Generator
• Roman Generator
• Chord Generator
• Scale Generator
• Diatonic Scale Generator
• Symmetric Scale Generator
• Interval Generator
• Pitch Generator
• Set Generator

Add Text Box: Simply start typing or select this command to add text to a page. Click the Controls icon at the upper right to open the Text Editor with basic word processing features and a selection of musical notational symbols. Use text to write instructional content, assignment directions, lessons, etc.

Add Multiple Choice: Select this command to add gradable questions to the page, providing another way of assessing student comprehension of course content. Type the question and answers directly in the text box on the page but use the Multiple-Choice Editor on the right side of the window to configure various elements. (Click the Controls icon to access the menu if it does not automatically appear.) Determine point values and how many answers may be selected as correct (i.e.one or multiple answers), and how many answers should appear on each line for preferred formatting. There are three answers to type by default, but teachers may add or remove answer choices by selecting the +/- symbols. Once you have typed the desired number of answers, move your cursor to the correct answer(s) and check the is Correct Answer box to enable automatic grading. Click on the up/down arrows to move answer-choice selections to the desired location.

Add Streaming Video: Select this command to add video content to a Harmonia document. To add video content, click here for more information or follow these steps:

1. Find or upload a video to YouTube or Vimeo and copy the link.
2. In Harmonia, click on the Add Streaming Video in the Insert menu. A blue video strip icon will appear in the margin beside a text-box cursor.
3. In the Streaming Video Editor on the right (accessed by clicking the Controls icon if it does not automatically appear), copy-and-paste the selected link.
4. Click the Test Video button to test the link. Add a text box to label or describe the video if desired.
5. Once the document is added to a course in the Harmonia Cloud, users may access the video by clicking on the video strip icon. Note: Internet connection is required to view video content.

Streaming Audio▸: Harmonia features high-quality in-app MIDI playback and supports streaming audio content. To add streaming audio content, click here for more information, or follow these steps:

1. Log in to the Harmonia website using a teacher account and select Media Library on the side bar. (Note: Media Library is only visible when logged in using a teacher account.)
2. Select the blue New Media Collection button. Give the collection a title, such as “Week 1 Files” or “Clara Schumann examples” or “Music Theory I”.
3. Upload the desired file(s). Give the file(s) a specific title if desired and click the download icon next to the file title to test the file. Harmonia accepts all currently available audio formats so there is no need to convert files first.
4. Drag and drop the files to reorder them within each media collection. You can also drag and drop the media collections to the desired order.
5. In the Harmonia app, log in using a teacher account. From the Insert menu, select Streaming Audio.
6. Select the desired file from the pulldown list. A blue headphone icon will appear next to a text box cursor.
7. Add a text box to label or describe the audio example if desired.
8. Once the document is added to a course in the Harmonia Cloud, users may access the audio by clicking on the headphone icon. Note: Internet connection is required to hear the audio content.

Add Image…: Choose this command to add pictures, charts, graphs, etc. to a page. Harmonia supports a variety of formats including GIF, JPG, and PNG. Use the Image Editor on the right to justify and resize the image. (Click the Controls icon to access the Image Editor if it does not automatically appear.)

Insert Line Break: Use this command to add line breaks to a Harmonia document.

Insert Page Break: Use this command to add page breaks to a Harmonia document

Media Menu Commands

Test Playback: Sends a burst of notes to the currently selected MIDI device to test MIDI playback.

Audio Settings…: Opens an audio device settings dialog to view and edit audio hardware settings.

Teacher Menu Commands

The Teacher Menu is only available when a registered teacher signs in.

User Roles: Select this command to toggle between teacher and student modes. Teacher mode enables authorized users to create and edit Harmonia documents; student mode mimics a student’s experience.

Convert Score To Assessment: Select this command to convert a score into a gradable assessment. To learn more, click here.

Show Grading Scale: Select this command to show the grading scale in a gradable assessment. The grading scale determines the exact point range for each grade level. To learn more, click here.

Clear Imported Scores: Select this command to remove (or delete) all imported scores from Harmonia's library folder.

Reveal Settings Folder: Select this command to locate and open a directory window containing Harmonia’s library folder.

Teacher Documentation: Use this command to quickly access Harmonia's online teacher documentation in your browser.

Help Menu Commands

Search: use this command to search Harmonia’s online documentation and tutorials.

Log in to the Harmonia Cloud: select this command to connect to a tutorial on Log in to the Harmonia Cloud.

Adding Documents to Assignment Sets: select this command to connect to a tutorial on Adding Documents to Assignment Sets.

Typing Intervals: select this command to connect to a tutorial on Typing Intervals.

Typing Chord Symbols: select this command to connect to a tutorial on Typing Chord Symbols.

Typing Roman Numerals: select this command to connect to a tutorial on Typing Roman Numerals.

Typing Pitches: select this command to connect to a tutorial on Typing Pitches.

Typing Scale Degrees: select this command to connect to a tutorial on Typing Scale Degrees.

Keyboard Shortcuts: select this command to connect to a list of Harmonia Keyboard Shortcuts.

Grading: Select this command to learn more about Harmonia’s automatic grading.

Visit Harmonia Website: Select the Help command to open Harmonia's online website in your browser.