Musical CSV · Tracks 1–2

Piano Roll / Pitched CSV

Piano, keyboards, strings and other pitched instruments; Track 2 may use a Double Bass SoundFont without becoming TAB.

86 current columns85-column legacy supportedUTF-8 CSV

How to author this format

One note event per row; simultaneous pitches may share a tick. Track 2 may select a double-bass SoundFont while using this Pitched format. This is not the Guitar TAB schema.

Keep exactly the supplied headers in their proper order. CSV supports commas inside quoted strings, and empty optional cells retain their position. Event rows are required for playable content; the header-only template is deliberately not playable.

All optional Pan_Position values use integer −100 to +100. Blank preserves the original SoundFont stereo placement, while 0 explicitly centres the note/strike/string. RC1 also accepts the earlier 85-column legacy layout without pan fields.

Composition length uses the declared full-measure final barline rather than the last note onset. Cross-track tempo, meter and composition length must agree. MIDI import into Studio first converts to a SymphonyCSV musical format.

Every column, in RC1 order

Descriptions distinguish input meaning, accepted-value guidance, and blank-cell meaning. The live Rust/WASM importer remains definitive for uncommon event values.

#Exact headerTypeMeaning, accepted values and blank handlingRequirement
1staffTextNames the notation staff for this event.
Accepted / units: Text, e.g. Upper staff or Lower staff
Blank: Not valid for a sounding Pitched event.
Required event/composition value
2measureIntegerOne-based bar number in the composition.
Accepted / units: Positive integer, 1 = first bar
Blank: Required for every event.
Required event/composition value
3count_aloudTextHuman-friendly counted onset inside the bar.
Accepted / units: Meter-specific count, e.g. One, Two and
Blank: Required on Pitched note rows.
Required event/composition value
4running_timeTextDisplay of the event onset on the whole-piece clock.
Accepted / units: m minutes and two-digit seconds; e.g. 0m 02s
Blank: Regenerate; do not invent it independently.
Conditional / optional / derived
5pitch_labelTextSounding concert pitch, including octave. Middle C is C4.
Accepted / units: Pitch such as C4, F#5 or Bb3
Blank: Required for a Pitched note.
Required event/composition value
6duration_beatsDecimalSounding note length measured in quarter-note beats.
Accepted / units: Positive decimal; 1 = quarter note, 0.25 = sixteenth
Blank: Required for a sounding note.
Required event/composition value
7duration_msIntegerCalculated duration of the event in milliseconds.
Accepted / units: Integer milliseconds
Blank: Recompute from authoritative timing.
Conditional / optional / derived
8velocityIntegerMIDI note-on attack strength, not mixer volume.
Accepted / units: Integer 1–127; 64 is a common starting choice
Blank: Required for a sounding note.
Required event/composition value
9tempo_bpmDecimalComposition tempo expressed as quarter notes per minute.
Accepted / units: Positive number, e.g. 92 or 120
Blank: Required; must agree across imported parts.
Required event/composition value
10time_signatureTextMeter used to interpret bars and counts.
Accepted / units: Text, e.g. 4/4; historical manual defines 2/4,3/4,4/4,5/4,6/8,7/8
Blank: Required; must agree across imported parts.
Required event/composition value
11key_signatureTextNotated tonal key, distinct from the actual MIDI pitches.
Accepted / units: Text, e.g. C major, Bb major
Blank: Do not infer or silently change a composer-selected key.
Conditional / optional / derived
12instrumentTextHuman-readable musical part or instrument name.
Accepted / units: Text, e.g. Piano, Bass, Strings
Blank: Historical default Piano; Studio routing is track-specific.
Conditional / optional / derived
13event_typeEnumKind of musical event represented by the row.
Accepted / units: Pitched baseline: note
Blank: Required event classification.
Conditional / optional / derived
14event_idTextStable, unique identifier used to review edits and receipts.
Accepted / units: Text ID; e.g. N00001
Blank: Do not silently regenerate IDs of surviving notes.
Conditional / optional / derived
15onset_beat_in_measureDecimalNumerical beat offset expressed with 1 at the barline.
Accepted / units: Decimal, 1 + elapsed quarter-note beats in the bar
Blank: Derived from count and meter.
Conditional / optional / derived
16onset_msIntegerEvent attack position from the start of the composition.
Accepted / units: Integer milliseconds
Blank: Recompute from tempo and tick position.
Conditional / optional / derived
17end_msIntegerEvent release position from composition start.
Accepted / units: Integer milliseconds
Blank: Recompute from onset and sounding duration.
Conditional / optional / derived
18midi_pitchIntegerAbsolute MIDI note number for the sounding pitch.
Accepted / units: Integer 0–127; C4 = 60
Blank: Derived from pitch_label for Pitched notes.
Conditional / optional / derived
19velocity_descriptionTextReadable dynamic description of the note velocity.
Accepted / units: Text such as p, mf or Medium
Blank: Display-level derived value; do not use instead of velocity.
Conditional / optional / derived
20written_pitchTextOptional engraved spelling, which may differ enharmonically from the sounding label.
Accepted / units: Text, e.g. Bb3 in place of A#3
Blank: No explicit spelling asserted.
Conditional / optional / derived
21pitch_spelling_sourceTextRecords how an engraving spelling was obtained.
Accepted / units: Text, e.g. composer, score or inference
Blank: No provenance assertion.
Conditional / optional / derived
22clefTextClef to present on the staff.
Accepted / units: Text, e.g. Treble or Bass
Blank: May be derived from the staff mapping.
Conditional / optional / derived
23clef_signTextNotation clef sign associated with the clef.
Accepted / units: Typically G or F for pitched staves
Blank: Derived from clef if omitted.
Conditional / optional / derived
24clef_lineIntegerStaff line where the clef sign is anchored.
Accepted / units: Integer; typical G clef = 2, F clef = 4
Blank: Derived from clef when possible.
Conditional / optional / derived
25voiceIntegerVoice number for notation within the staff.
Accepted / units: Positive integer
Blank: Exporter or reader may infer a notation voice.
Conditional / optional / derived
26notated_typeEnumEngraved duration category, independently of sounding duration.
Accepted / units: whole, half, quarter, eighth, 16th in historical guide
Blank: Reader may choose notated appearance; no assertion.
Conditional / optional / derived
27notated_duration_beatsDecimalOptional written note value in quarter-note beats.
Accepted / units: Positive decimal
Blank: Follow sounding duration when not separately specified.
Conditional / optional / derived
28notated_dotsIntegerAugmentation-dot count for written notation.
Accepted / units: Nonnegative integer
Blank: Notation may infer dotting.
Conditional / optional / derived
29tie_startBooleanNotation flag indicating the beginning of a tie.
Accepted / units: Boolean text / encoded truth value
Blank: No start of tie explicitly asserted.
Conditional / optional / derived
30tie_stopBooleanNotation flag indicating the end of a tie.
Accepted / units: Boolean text / encoded truth value
Blank: No end of tie explicitly asserted.
Conditional / optional / derived
31articulationTextWritten/performance articulation of the event.
Accepted / units: Text such as staccato, accent, tenuto, marcato
Blank: No articulation specified.
Conditional / optional / derived
32beamTextExplicit beaming role in notated rhythm.
Accepted / units: begin, continue or end in original manual
Blank: Notation may infer beaming.
Conditional / optional / derived
33midi_file_formatIntegerStandard MIDI File structural format policy.
Accepted / units: Integer, historical default 1
Blank: Must use consistent export policy.
Conditional / optional / derived
34ticks_per_quarterIntegerMIDI timeline resolution: ticks per quarter note.
Accepted / units: Positive integer; current fixtures commonly use 480
Blank: Do not assume a hard-coded value; read the file.
Conditional / optional / derived
35midi_trackIntegerTrack number used in MIDI export and mappings.
Accepted / units: Nonnegative integer; conductor often track 0
Blank: May be mapped from Studio track/staff.
Conditional / optional / derived
36midi_track_nameTextReadable name of the target MIDI track.
Accepted / units: Text
Blank: Can be derived from part/staff if absent.
Conditional / optional / derived
37midi_channelIntegerMIDI channel assigned to this part.
Accepted / units: Integer 1–16 in the format documentation
Blank: Requires track/part mapping if absent.
Conditional / optional / derived
38midi_programIntegerZero-based General MIDI program number.
Accepted / units: Integer 0–127; Acoustic Grand Piano = 0
Blank: Mapped or chosen by instrument profile.
Conditional / optional / derived
39program_change_emitYes/NoWhether a MIDI program-change event should be emitted.
Accepted / units: Yes or No
Blank: Historical default No; do not emit changes unasked.
Conditional / optional / derived
40program_sourceTextProvenance of the MIDI program selection.
Accepted / units: Text
Blank: No source assertion.
Conditional / optional / derived
41midi_bank_msbIntegerOptional MIDI bank-select most-significant byte, CC0.
Accepted / units: Integer 0–127
Blank: No bank event requested.
Conditional / optional / derived
42midi_bank_lsbIntegerOptional MIDI bank-select least-significant byte, CC32.
Accepted / units: Integer 0–127
Blank: No bank event requested.
Conditional / optional / derived
43note_off_methodEnumPolicy for serializing note release events.
Accepted / units: note_off or note_on_velocity_zero
Blank: Historical default note_on_velocity_zero.
Conditional / optional / derived
44note_off_velocityIntegerRelease velocity when a note-off is sent.
Accepted / units: Integer 0–127; often 0
Blank: Historical default 0.
Conditional / optional / derived
45absolute_tickIntegerOnset tick counted from the composition start.
Accepted / units: Nonnegative integer
Blank: Recompute from measure and local onset.
Conditional / optional / derived
46onset_tick_in_measureIntegerTick offset after the start of the bar.
Accepted / units: Nonnegative integer
Blank: Recompute from local onset.
Conditional / optional / derived
47duration_ticksIntegerSounding duration in MIDI ticks.
Accepted / units: Positive integer for sounding notes
Blank: Recompute from beats and tick resolution.
Conditional / optional / derived
48end_tickIntegerAbsolute release tick of the note.
Accepted / units: Nonnegative integer; onset tick + duration ticks
Blank: Recompute from event timing.
Conditional / optional / derived
49tempo_us_per_quarterIntegerMIDI tempo as microseconds for one quarter note.
Accepted / units: Positive integer; 60,000,000 / tempo_bpm
Blank: Recompute from tempo_bpm.
Conditional / optional / derived
50tempo_beat_unitTextUnit against which the BPM count is expressed.
Accepted / units: quarter in the original six-meter baseline
Blank: Historical policy is quarter.
Conditional / optional / derived
51pitch_octave_conventionTextDefines the pitch/octave naming system.
Accepted / units: C4=60 in the reference format
Blank: Policy must remain consistent.
Conditional / optional / derived
52tick_rounding_policyTextStates how fractional tick results are rounded/handled.
Accepted / units: Text policy; respect actual imported policy
Blank: Do not silently invent new rounding.
Conditional / optional / derived
53same_tick_event_orderTextOrdering policy for simultaneous note releases and attacks.
Accepted / units: note_off_before_note_on in reference
Blank: Protect deterministic retrigger ordering.
Conditional / optional / derived
54time_signature_numIntegerNumerator derived from the time signature.
Accepted / units: Positive integer, e.g. 4 for 4/4
Blank: Computed from time_signature.
Conditional / optional / derived
55time_signature_denIntegerDenominator derived from the time signature.
Accepted / units: Positive integer, e.g. 4 for 4/4
Blank: Computed from time_signature.
Conditional / optional / derived
56key_signature_fifthsIntegerCircle-of-fifths encoding of key signature.
Accepted / units: Integer; flats negative, sharps positive
Blank: Derived from key_signature.
Conditional / optional / derived
57key_signature_modeTextMajor/minor designation for MIDI key signature.
Accepted / units: major or minor
Blank: Derived from key_signature.
Conditional / optional / derived
58controller_numberIntegerGeneric MIDI Continuous Controller number.
Accepted / units: Integer 0–127
Blank: No generic controller event.
Conditional / optional / derived
59controller_valueIntegerValue for the generic MIDI controller above.
Accepted / units: Integer 0–127; zero is explicit
Blank: No generic controller event; verify paired fields.
Conditional / optional / derived
60cc1_modulationIntegerMIDI CC1 modulation amount.
Accepted / units: Integer 0–127
Blank: Do not emit controller event.
Conditional / optional / derived
61cc2_breathIntegerMIDI CC2 breath controller amount.
Accepted / units: Integer 0–127
Blank: Do not emit controller event.
Conditional / optional / derived
62cc7_channel_volumeIntegerMIDI CC7 channel volume; different from note velocity.
Accepted / units: Integer 0–127
Blank: Do not emit controller event.
Conditional / optional / derived
63cc10_panIntegerMIDI CC10 pan position.
Accepted / units: Integer 0–127; centre 64
Blank: Do not emit controller event.
Conditional / optional / derived
64cc11_expressionIntegerMIDI CC11 musical expression amount.
Accepted / units: Integer 0–127
Blank: Do not emit controller event.
Conditional / optional / derived
65cc64_sustainIntegerMIDI CC64 sustain-pedal state.
Accepted / units: Integer 0–127; >=64 generally on
Blank: Blank means no event, not pedal release.
Conditional / optional / derived
66cc91_reverb_sendIntegerMIDI CC91 reverb send, not Studio’s necessarily separate audio effect settings.
Accepted / units: Integer 0–127
Blank: Do not emit controller event.
Conditional / optional / derived
67cc93_chorus_sendIntegerMIDI CC93 chorus send, not Studio’s necessarily separate audio effect settings.
Accepted / units: Integer 0–127
Blank: Do not emit controller event.
Conditional / optional / derived
68pitch_bendIntegerRaw MIDI pitch bend position for this event.
Accepted / units: Integer 0–16383; centre 8192
Blank: No pitch-bend message requested.
Conditional / optional / derived
69channel_aftertouchIntegerChannel-wide pressure aftertouch amount.
Accepted / units: Integer 0–127
Blank: No channel-pressure event.
Conditional / optional / derived
70poly_aftertouchIntegerPer-note pressure aftertouch amount.
Accepted / units: Integer 0–127
Blank: No per-note aftertouch event.
Conditional / optional / derived
71sysex_payloadTextMIDI System Exclusive content if implemented by an exporter.
Accepted / units: Text payload; codec/encoding must be specified separately
Blank: No SysEx message.
Conditional / optional / derived
72controller_event_policyTextDescribes whether an empty controller column emits an event.
Accepted / units: Text policy; reference: blank = emit no event
Blank: Do not assume unspecified controller events.
Conditional / optional / derived
73composition_titleTextTitle establishing the identity of the shared composition.
Accepted / units: Text; identical across participating tracks
Blank: Required to establish/import a composition.
Required event/composition value
74composerTextHuman-approved composer credit.
Accepted / units: Text
Blank: Never fabricate a composer credit.
Conditional / optional / derived
75composition_total_measuresIntegerDeclared total number of full measures in the composition.
Accepted / units: Positive integer; same across tracks
Blank: Required for synchronized composition identity.
Required event/composition value
76composition_end_tickIntegerFinal measure closing barline, independent of final note onset.
Accepted / units: Integer computed from meter × ticks-per-quarter × total measures
Blank: Recompute/verify; do not end early at last note.
Required event/composition value
77composition_durationTextReadable whole-piece length for display.
Accepted / units: Text such as 0m 08s
Blank: Derived from full-measure composition length.
Conditional / optional / derived
78lyricTextLyric syllable attached to the musical event.
Accepted / units: Text
Blank: No lyric attached.
Conditional / optional / derived
79markerTextSection marker or structural cue at an onset.
Accepted / units: Text
Blank: No marker attached.
Conditional / optional / derived
80source_note_dataTextExplains the provenance of note content.
Accepted / units: Text
Blank: No note-source claim recorded.
Conditional / optional / derived
81source_clefTextExplains where the chosen clef came from.
Accepted / units: Text
Blank: No clef-source claim.
Conditional / optional / derived
82source_key_signatureTextExplains evidence for the selected key signature.
Accepted / units: Text
Blank: No key-source claim.
Conditional / optional / derived
83source_instrumentTextExplains the observed or authored instrument/program choice.
Accepted / units: Text
Blank: No instrument-source claim.
Conditional / optional / derived
84source_licenseTextDescribes the rights/licence of source musical material.
Accepted / units: Text; verify externally before redistributing
Blank: No licence claim. Do not assume public domain.
Conditional / optional / derived
85source_urlURLA source reference for provenance and attribution.
Accepted / units: URL text
Blank: No source URL claimed.
Conditional / optional / derived
86Pan_PositionIntegerPlaces this musical note or drum hit in the stereo field; each event can be positioned independently.
Accepted / units: Whole integer −100 (hard left) through 0 (centre) to +100 (hard right); fractional positions and values outside the range are rejected by RC1 pan validation.
Blank: No authored pan override; preserve the loaded SoundFont’s native stereo placement. A blank is NOT the same as 0.
Example: −40, 0, 70, or blank
Optional stereo placement

86 columns