PIANO PERFORMANCE ASSESSMENT SYSTEM Quick Start Guide | Version 1.1 REQUIREMENTS Apple Silicon Mac (M1 or later), macOS 14 or later. Tested on macOS 26.6.2. This application package is not compatible with Windows or Intel Macs. No separate Python or VS Code installation is required. A MIDI keyboard connected to the computer is required to record and assess a new performance. No MIDI keyboard is needed to play the sample reference MIDI or review the accompanying project PDF and demonstration video. GETTING STARTED 1. Extract the ZIP file and double-click PianoAssessment.app. 2. Click Import Reference MIDI. Select Twinkle_Twinkle_Little_Star.mid from the sample folder that opens, or choose your own reference MIDI file. 3. Click Play Reference MIDI to listen. Click Stop All Audio to stop playback. RECORD AND ASSESS 4. Connect your MIDI keyboard. Click Refresh Ports, then select the keyboard's input under MIDI Input. 5. Adjust BPM and Beats / Bar if needed. Auto-start When Recording controls whether the metronome starts with recording. 6. Click Start Recording (Live Feedback), perform the piece, then click Stop Recording. 7. Select Pitch, Rhythm, Dynamics, or Overall to view assessment results. Dynamics describes MIDI note-on velocity differences. 8. Click Replay Performance to listen to the recorded performance, or View Staff & Error Notes to inspect the notation and highlighted errors. 9. Click Export JSON Report and choose where to save the report. NOTES The interface does not import saved JSON performances for reassessment. Without a MIDI keyboard, use reference playback and the supplied sample results to explore the project. If no input appears, check the keyboard's power and MIDI connection, then click Refresh Ports. If playback is silent, check the Mac's volume and sound output device. This prototype has not been notarized by Apple; macOS may display a verification warning when it is downloaded.