Convert Mscz To Midi Verified File

converter = MSCZtoMIDIConverter()

This is useful if you need to programmatically manipulate the MusicXML first.

mscore.exe -o output.mid input.mscz

To verify a correct .mscz → .mid conversion, the following must be checked:

| Aspect | How to Verify | |--------|----------------| | Pitch accuracy | Compare original score notes vs. MIDI notes in a DAW or MIDI monitor | | Rhythm & timing | Check MIDI event timestamps against score rhythm (resolution = 480–960 PPQ typical) | | Tempo | MIDI tempo meta events (Set Tempo) should match score’s tempo markings | | Dynamics | MIDI Velocity (0–127) mapped to score dynamics (ppp→fff). MuseScore usually maps well. | | Articulations | Staccato, accents → often converted as velocity changes or note length adjustments. Not perfect, but verifiable. | | Track/channel mapping | Each instrument in score → separate MIDI track/channel | | Playback completeness | No missing or extra notes |

# example_usage.py
from mscz_to_midi_converter import MSCZtoMIDIConverter convert mscz to midi verified
Before you send your MIDI file to a collaborator or load it into a DAW, run this 60-second verification check:
| Test | Pass/Fail |
| :--- | :--- |
| Track Count: Does the MIDI have the same number of tracks as the MSCZ had staves? | [ ] |
| Note Cutoff: Play the last bar. Do the notes ring out or cut off suddenly? | [ ] |
| Pickup Measure: If your piece starts on beat 3, does the MIDI start on beat 3? | [ ] |
| Dynamics: Are the quiet parts quiet and loud parts loud? | [ ] |
If you answer "Pass" to all four, your conversion is verified. converter = MSCZtoMIDIConverter()

Many free online converters produce corrupt or "flattened" MIDI files. A verified conversion must preserve the following elements from your original MSCZ:

If your converter loses track separation (i.e., everything merges into one piano track), the conversion is not verified.

# cli.py
import argparse
import sys
from pathlib import Path
from mscz_to_midi_converter import MSCZtoMIDIConverter This is useful if you need to programmatically
def main():
parser = argparse.ArgumentParser(
description='Convert MuseScore (.mscz) files to MIDI format with verification'
)
parser.add_argument('input', help='Input .mscz file or directory')
parser.add_argument('-o', '--output', help='Output file or directory')
parser.add_argument('-v', '--verify', action='store_true', default=True,
                   help='Verify conversion quality (default: True)')
parser.add_argument('--no-verify', action='store_false', dest='verify',
                   help='Skip verification')
parser.add_argument('-b', '--batch', action='store_true',
                   help='Batch convert all .mscz files in directory')
parser.add_argument('--pattern', default='*.mscz',
                   help='File pattern for batch conversion (default: *.mscz)')
args = parser.parse_args()
converter = MSCZtoMIDIConverter()
if args.batch or Path(args.input).is_dir():
    # Batch conversion
    input_dir = Path(args.input)
    output_dir = Path(args.output) if args.output else input_dir / 'midi_output'
print(f"Converting all .mscz files from input_dir to output_dir")
    results = converter.batch_convert(
        str(input_dir), 
        str(output_dir), 
        args.pattern
    )
print(f"\nConversion Results:")
    print(f"  Total: results['total']")
    print(f"  Successful: results['successful']")
    print(f"  Failed: results['failed']")
for conv in results['conversions']:
        status = "✓" if conv['success'] else "✗"
        verified = " [VERIFIED]" if conv.get('verified') else ""
        print(f"  status conv['input'] -> conv['output']verified")
else:
    # Single file conversion
    input_file = Path(args.input)
    output_file = Path(args.output) if args.output else None
print(f"Converting input_file...")
    result = converter.convert(str(input_file), str(output_file) if output_file else None, 
                               verify=args.verify)
if result['success']:
        print(f"✓ Conversion successful!")
        print(f"  Method: result['method']")
        print(f"  Output: result['output_path']")
        print(f"  Size: result['file_size'] bytes")
if 'verification' in result:
            verif = result['verification']
            print(f"\nVerification Results:")
            print(f"  Passed: verif['passed']")
            print(f"  Quality: verif.get('quality', 'unknown')")
            print(f"  Note events: verif['checks'].get('note_events', 0)")
            print(f"  MIDI tracks: verif['checks'].get('num_tracks', 0)")
    else:
        print(f"✗ Conversion failed: result.get('error', 'Unknown error')")
        sys.exit(1)

if name == 'main':
main()