Production Guide

From MMS Wiki
Revision as of 07:46, 27 September 2016 by Kristokao (talk | contribs) (Production tool how to use)
Jump to: navigation, search

What is MMS/PF and how it works


Log in to and click through the tutorial. If tutorial mode is disabled, please enable it from your profile.

Student view

Student view includes and Assignments tab and Content tab. The first tab is always opened by default. URL looks like this (incase you need to switch to a student view from the teacher view): comp.html#/student/assignments Any user without teacher rights will see the student view.

Teacher view

Teacher view includes Students tab, Content tab, My exercises tab, and Favorites tab. The first tab is always opened by default. URL looks like this /comp.html#/teacher/students To access the teacher view you need to be granted the rights. This can be done by any administrator. At the bottom of the default page of teacher view (students tab) you see a text 'If you created a teacher account by accident, you can: revert back to student account' This will remove your teacher rights.


Google Chrome (free). All our products are optimized for Google Chrome. You have no reason to use any other browser.[1]

MuseScore (free). Get our version here: Win: [2]. Mac: [3]. Our version has an important extra feature - linearize.

Sibelius (not free, MMS has a licence)

Finale (Finale Notepad is free and does what we need). [4]

Audacity (free). You will occasionally need to edit some audio files. [5]

Google account For MMS/PF and for accessing the metadata on Drive


Adding collections

A user with collections rights can create a new collection at /comp.html#/edit_collection/ At least title field has to be filled under the metadata tab. Scroll down to 'save'.

Cloning an existing collection (only metadata will be copied) can be done on edit page of an existing collection.

Naming and publishing collections

If 'Publish this collection (ready)' is ticked then it will show up under the set package to the consumer group that has rights to see that package.

Cover art

The design works best with landscape images. Please do not link big image files, 100 kb is enough.

Adding exercises to a collection

- Existing exercises can be added under the edit_collection page's Exercises tab. The exercise list in the dropdown includes exercises from the user's collections 'Favorite Exercises' and 'My Exercises'. It is a non-preferred use case.

- When creating an exercise through the production tool a collection can be chosen from the dropdown. It's the preferred use case but unavailable through the public exercise creation flow.


Under the exercise tab on edit collection page one can add subdivisions. Those will appear at the bottom of exercise list and can be dragged into correct position (use scroll wheel and PgUp). Subdivisions have two functions: 1) they help to group the exercises and will divide content into two columns 2) they allow to assign the full content of a subdivision to students (for example, name it Lesson 1, drag appropriate exercises under that division and later assign the whole lesson at once).

- When creating an exercise through the public exercise creation flow this URL can be used to automatically include the exercise into a collection /comp.html#/create_notes?to_collection=<collection id>

Converting files

From .mus to MusicXML From .sib to MusicXML From XML to .mscz

Editing on MuseScore

The principles Keep in mind the context of use (sufficient space for feedback) Does not have to be a clone of print music Moving and defining elements (select all, styles) Excerpts/parts

Naming and storing files

How to name Where to keep

Production tool how to use

Step 1: Upload .mscz file

The file should be previously checked in the same MuseScore version that we currently have on server side (Usually the latest stable version). All parts have to be generated in local MuseScore and the same goes for line breaks and other visuals. Linearization has to be done in advance, too. Although MMS detects and separates the parts and tries to linearize the music, often the result is not sufficient.

Step 2: Collection and audio files

- Choose collection. The collection has to be created in advance, see above.

- Upload audio files .ogg is the best since everything gets converted into ogg anyway. Choose all needed audio files at once and make sure that their order is always the same (e.g. demo track, reference track, backing track) to avoid problems in next phases where file names cannot always be seen.

Step 3:

-Which parts to keep which to delete? -Naming the instruments -Checking the boxes

Backing track. The rule of thumb is that it must not contain the reference track. If this is not possible then there will be no backing track at all. Most users never hear that track because they either don't hit 'Record' and are just browsing or they use the other recording options.

Reference track (internally called 'etalon'). Best if we have a real instrument track from the publisher. If not then it is worth checking if the existing audio tracks have panned the material into separate stereo channels. Then we can form two different mono tracks. One of them will work as reference audio. For instance, see collection 452. If there is no way of doing that then we use MIDI. NB! This track is not audible to users.

Demo track. The audio track that comes with the book. It usually gives the student an idea how everything should sound. MIDI is our choice only if we have no real audio tracks. Guitar chords played with MIDI sound awful and should only be used in the audio layer where nobody can hear them (the reference track). This is the track that is played the most.

Advanced view Add new excerpt Step 4: Aligning In tempo mode (when to use) Matching mode (when to use) ‘Save and Load’, how to use The grid What it is, why two? Moving and navigating (Home, End, Spacebar, PgUp, PgDn, Level of accuracy (depends on the context - if etalon is real audio then it just has to look good) Step 5: Aligning the MIDI and real audio Step 6: Play all Play individual files Review the sync Move with shift+click Add New audio file

Edit exercise page

Review the sync and look Naming the exercise Default score goal Public vs not public Exercise description Attachments Sections Adding Youtube video Exercise page for admin Play all Play backing Play etalon Play demo audio

Documenting your actions

General sfuff

Create and use shortcuts Track time, avoid wasting it Use Google, read forums. If nothing helps, ask Kristo