read_open_score
Export the open score as MusicXML to a chosen folder, then read back the full contents. Get reliable bar count, key, time signature, and pickup bar information.
Instructions
Read the whole open score back by way of a MusicXML export.
The only route to the full contents of the score that is open. Reads over the
Remote API see the selection alone, so everything else here works blind. This
is what makes bar count, key, time signature and above all a pickup bar
knowable instead of guessed.
Returns:
Result dictionary with the parsed summary, the pickup finding, the last
bar number, and the file that was read.
Note:
Dorico's MusicXML export filter opens a modal dialog that requires user
confirmation. This tool triggers the export dialog and awaits the resulting
file in export_dir. Point the export dialog to export_dir once in Dorico to
enable one-key export confirmations on subsequent reads.
The result is a snapshot of the score at export time. Re-export after
edits to refresh score state.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trigger | No | True opens Dorico's MusicXML export dialog first. False skips that and reads whatever MusicXML already lies in the folder, which is what to use after a timeout or a manual export. | |
| export_dir | Yes | Folder Dorico's export dialog is pointed at. The newest MusicXML file that appears there is the one read back. | |
| wait_seconds | No | How long to wait for the file while a person confirms the dialog. The call returns as soon as one appears. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||