Introduction

MyrScript is the embedded programming language, included in Harmony Assistant starting in version 8.3.

It is not necessary to know how to program to use MyrScript.  You can already use many existing scripts that add new features to Harmony Assistant. These scripts have been written either by the Myriad team to match users' requests, or by Harmony users themselves.

But if you think that a feature is missing, you can add it using the MyrScript language. In that case, basic knowledge of computer programming is required. A detailed and complete programming manual, along with many examples, is provided for this purpose.

New scripts or existing script updates will be provided frequently on the Myriad Website.

What has to be installed to use MyrScript?

Nothing.

Everything you need is included in Harmony Assistant.

What does MyrScript enable?

For example, here are some new features MyrScript has brought:

- Tablatures for wind instruments: recorder, ocarina, tuba, flute, clarinet...
- Fingering display while music is playing: a must to learn how to play an instrument
- Analog drum sound generator
- Note name display
- Tempo adjustment on digital tracks
- Echo of notes played on computer (or MIDI) keyboard
- Digital or analog clock
- Selected notes duration conversion
- Selected notes pitch conversion
- Real-time fingering for guitar, bass, and other fretted string instruments
- Velocity humanizing
- Portamento effect on a group of notes
- Virtual Singer language forcing
- Singers' placement on stage
- SAMPA display while Virtual Singer is singing
- Separated parts printing
- E-mail address change for a whole set of files
- Parallel fifth and octave check
- Revert to last saved version of the document
- Note sequence search in a document or a set of documents

And many others...

How to use MyrScript?

MyrScript is accessed through the "Scripts" menu.
First, "About scripts..." displays the script documentation, including a precise description of what each script performs.
Then, "Internet update" connects to the Myriad server to update scripts or download the new scripts.
Below that, all the available scripts are listed, sorted by category.

To run a script, simply select its name in the menu.

How to add a script to the user's palette?

Adding a script to the user's palette provides a quick way to launch a script.
Select the script in the "Scripts" menu with the shift key down: a button will be created in the user's palette.
Clicking this button launches the script.

And if I want to write my own scripts?

The first step is to read the scripting developer manual. You can get it through the "Scripts" menu. Options at the bottom of the menu are reserved to MyrScript developers.

The developer manual includes many examples you are invited to study carefully.

Then, you can view the source code of the included scripts, and even use parts of them to write your own script.

Finally, if you intend to share your work with other users, send it to us.

But also...

If you want to discuss scripting with other users or programmers, or submit a request for a new script you need, visit the special section of the Web board dedicated to the topic: http://www.myriad-online.com/cgi-bin/bbs/YaBB.pl