Production Guide

From MMS Wiki
Jump to: navigation, search

What is MMS/PF and how it works


Functionality

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

Student view

Student view includes 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 and Content tab. (the marching band edition also has Events 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.

Tools


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 (not free, MMS has a licence. Finale Notepad is free and does most of the things you 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

Collections


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.

Subdivisions

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). The subdivisions are designed to be added after exercises. To navigate the subtitles into their correct places use left click+scroll (or PgUp, Home buttons).

- 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 in 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


Organize the files so that you can always get them incase you need to redo an exercise. A sample folder structure: main catalogue is 'Book Title With All Numbers' in which you have 'mscz' for MuseScore files, 'sib' for Sibelius files, 'mus' for Finale files, 'xml' for MusicXML files, 'art' for cover art and pdf files.

Production tool how to use

Note! Production tool is separate from the public exercise creation flow. It can only be accessed by MatchMySound's own production team.


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 of the alignment always depends on the context - if the reference track 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

Track your production activities so that you and other people could understand what (when, why, who) have you done even after you have forgotten everything.


General sfuff


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