NAME

nwc2musicxml - Convert NoteWorthy Composer 2 files to MusicXML.

VERSION

0.001.1

SYNOPSIS

nwc2musicxml [options] input.nwc [output.musicxml]
nwc2musicxml [options] file1.nwc file2.nwc ...
nwc2musicxml --recursive --output-dir musicxml scores/

DESCRIPTION

Converts NoteWorthy Composer 2 binary .nwc score files into MusicXML .musicxml files suitable for import into MuseScore and other MusicXML- compatible notation programs.

NoteWorthy Composer does not need to be installed.

OPTIONS

--help, -h

Print this help text and exit.

--version, -V

Print the program version and exit.

--verbose, -v

Emit per-file progress information.

--quiet, -q

Suppress all non-error output.

--debug

Emit low-level pipeline tracing (very chatty).

--overwrite

Overwrite existing output files. By default, existing files are skipped.

--recursive, -r

When a directory is given as input, descend into subdirectories. The relative directory structure is preserved under --output-dir.

--output-dir DIRECTORY, -o DIRECTORY

Write all output files to DIRECTORY.

--format FORMAT

Output format. Currently only musicxml (default) is supported.

--validate

Perform extended consistency checks on the converted score (pitch validity, tie/slur pairing, measure duration sums, etc.).

--warnings FILE

Write all warnings to FILE in addition to STDERR.

EXIT CODES

0 -- successful conversion (no warnings)
1 -- conversion completed with warnings
2 -- invalid or unsupported input
3 -- output error
4 -- internal / programming error

EXAMPLES

# Convert a single file
nwc2musicxml Pilgrim.nwc

# Convert with explicit output name
nwc2musicxml Pilgrim.nwc Pilgrim.musicxml

# Convert all .nwc files to a directory
nwc2musicxml --output-dir musicxml *.nwc

# Recursive conversion preserving directory structure
nwc2musicxml --recursive --output-dir musicxml scores/

# Validate and log warnings
nwc2musicxml --validate --warnings conv.log Pilgrim.nwc

AUTHOR

Nigel Horne <njh@nigelhorne.com>

LICENSE

Copyright 2026 Nigel Horne.

Usage is subject to the GPL2 licence terms. If you use it, please let me know.