Changes for version 0.001.0 - 2026-09-18

  • Initial CPAN release. Fully functional NWC-to-MusicXML conversion pipeline.
  • Core modules:
  • Music::NWC2MusicXML -- top-level facade; single-file and batch conversion.
  • Music::NWC2MusicXML::NWC -- NWC 2.x binary container decoder (zlib decompression).
  • Music::NWC2MusicXML::Parser -- NWCTXT text parser producing Score/Staff/Event trees.
  • Music::NWC2MusicXML::Score -- internal score model.
  • Music::NWC2MusicXML::Staff -- internal staff model.
  • Music::NWC2MusicXML::Event -- internal event model with exact rational durations.
  • Music::NWC2MusicXML::MusicXML -- MusicXML 4.0 generator.
  • Music::NWC2MusicXML::Diagnostics -- i18n warning/logging subsystem.
  • bin/nwc2musicxml -- command-line interface.
  • MusicXML features emitted:
  • Notes, chords, rests (all NWC durations; dotted, double-dotted, triplets).
  • Grace notes (<grace/> element; duration omitted per MusicXML schema).
  • Slurs (numbered 1-6 for simultaneous arcs), ties, articulations, ornaments.
  • Clef, key-signature, and time-signature changes (initial and mid-staff).
  • Transposing instruments (<transpose><chromatic>).
  • Tempo and tempo-variance directions (metronome, rit., accel., etc.).
  • Dynamic markings with per-staff MIDI velocity (DynVel) mapping.
  • Hairpin crescendo/diminuendo wedges.
  • Text directions, flow-control marks (coda, segno, D.C., D.S., Fine, ...).
  • Lyrics with syllabic type (begin/middle/end/single).
  • Part groups (bracket and brace) from WithNextStaff flags.
  • MIDI channel, program, volume, and pan from NWC staff properties.
  • Visible/hidden staves (print-object="no" on part-name).
  • Custom ending barlines from NWC EndingBar property.
  • Asymmetric page margins (Left/Right/Top/Bottom from PgMargins).
  • Word-font and lyric-font defaults from NWC Font records.
  • Score metadata: title, author, lyricist, copyright, comments.
  • Repeat barlines (MasterRepeatOpen/Close, LocalRepeatOpen/Close).
  • Double, section-close, and other barline styles.
  • CLI features:
  • Single-file and batch conversion.
  • Recursive directory scanning (--recursive).
  • Selectable output directory (--output-dir).
  • Overwrite guard (--overwrite).
  • Warning log file (--warnings).
  • Extended consistency validation (--validate).

Documentation

Convert NoteWorthy Composer 2 files to MusicXML.

Modules

Convert NoteWorthy Composer 2 .nwc score files to MusicXML.
Warning collection, logging, and reporting for the Music::NWC2MusicXML conversion pipeline.
Internal representation of a single NWC musical event or score metadata record.
Convert an internal Score object to a MusicXML 4.0 document string.
Binary NWC container decoder.
NWCTXT text parser producing an internal score representation.
Internal representation of a complete NWC score.
Internal representation of a single NWC staff.