Difference between revisions of "Production Guide"

From MMS Wiki
Jump to: navigation, search
(Production tool how to use)
(Adding Sections)
Line 134: Line 134:
== Adding Sections ==
== Adding Sections ==
Normal section
Normal section
Impro section
Impro section
Line 141: Line 141:
'''Step 5: Verification'''
'''Step 5: Verification'''
Go to the [[Playback menu]] and listen to 'All audio tracks' as well as all the individual tracks and Metronome. Compare each audio file playback to the musical score and verify that they are perfectly synchronized.  
Go to the [[Playback menu]] and listen to 'All audio tracks' as well as all the individual tracks and Metronome. Compare each audio file playback to the musical score and verify that they are perfectly synchronized.
== Editing and repairing existing exercises ==
== Editing and repairing existing exercises ==

Revision as of 13:00, 25 October 2018

Production tools

In addition to the MMS Production Tool you will need some or all of the following:

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 - Linearization.

Sibelius (not free, MMS has a licence)

PhotoScore or PhotoScore Lite which comes for free with the Sibelius license.

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


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 the Edit Collection page.

Naming and publishing collections

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

Cover art

The design works best with portrait oriented images. Do not upload big image files, 100 kb is enough.

Adding exercises to a collection

- Existing exercises can be added on the Edit Collection page's Actions menu. The exercise list in the drop-down 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 MMS production tool a collection can be chosen from the drop-down. It's the preferred use case but unavailable through the public exercise creation flow.


In the Actions menu on the Edit Collection page, one can add subdivisions. Those will appear at the bottom of the exercise list and can be dragged into the 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 assigning 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 MMS public exercise creation flow the following 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 - Use Finale's default Export to MusicXML tool or Finale Dolet plugin

From .sib to MusicXML - Use Sibelius's Export to MusicXML tool

From XML to .mscz - Open directly in MuseScore

From Guitar Pro to .mscz - Open directly in Musescore (supported since .gp3)

From .pdf to .mscz - Use PhotoScore

Editing in MuseScore

Editorial 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): Make sure all elements are designated and styled properly, do not use wrong styles (e.g. do not designate ritenuto as free text, make it dynamics). Same goes for placement - do not just drag elements around, use their default positions if possible.

- Export the parts before leaving MuseScore. (Inside MuseScore, the parts are called Excerpts. An excerpt can be a combination of parts).

- You cannot optimize for both page and scroll view, choose one (depends on the use case, when in doubt, make page view look good).

Naming and storing files

Organize the files so that you can always get them in case 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.

The 2017 version of the MMS allows some user groups to download the score and audio files from the existing exercises. It is meant for making the repairing work easier. Still, keeping a well-organized archive of all the relevant files is strongly recommended.

Production tool how to use

Note! The MMS Production tool is separate from the public exercise creation flow. It can only be accessed by MatchMySound's own production team or the partners who specifically license that from us.

Step 1: Upload score file

The file should be previously checked in the same MuseScore version that we currently have on the 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: Audio files and parts

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

- Add Youtube video link (just the 8-10 last characters of the YT URL). The video must have exactly the same audio file that you plan to use as the Reference track.

- Choose tempo for MIDI. It is taken from the MuseScore file, change it if you need. If you are using real audio files then make the MIDI tempo match the audio recording (loosely).

- Choose Full audio track. It is the track which will be accessible from all the individual parts. Different products may use it differently.

- Exercise parts configuration. Click on a part to open its settings and set the Name, Instrument (always choose from what the autocomplete suggests) Etalon (alias for the Reference track), Audio (alias for the Demo track), and the Backing track. Lastly, set the Score visual (can be any of the individual parts or the full score). Percussion track means that the Recording option will be turned off (use it for drums).

- If you don't need all the excerpts/parts, then you can delete some. It's also possible to add them back by clicking the '+Add new part' button below.

- If you are not using real audio files, you will see a button labelled 'Create MIDI only exercise'. If you are using at least one audio file, you need to proceed to the mapping phase (see next step).

Step 3: Map audio to score

Click on the 'i' next to the title Map audio to score in order to see the keyboard bindings.

- In tempo mode (when to use) - Matching mode (when to use) - ‘Save and Load’, how to use - The grid. What it is, why two? Level of the accuracy of the alignment always depends on the context - if the reference track is real audio then it just has to look good.

Step 4: Align audio files

Advice on choosing the audio files

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

Adding Sections

Normal section Impro section

Step 5: Verification

Go to the Playback menu and listen to 'All audio tracks' as well as all the individual tracks and Metronome. Compare each audio file playback to the musical score and verify that they are perfectly synchronized.

Editing and repairing existing exercises

Replacing the MuseScore file Replacing the audio files Repairing the sync

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