mscore
Display MuseScore's score format information
TLDR
View documentation for the original command
SYNOPSIS
mscore [OPTIONS] [FILE...]
PARAMETERS
--help
Displays usage information and exits.
--version
Displays the MuseScore version and exits.
-o <file>, --output <file>
Specifies the output file name for export or print operations.
-e <format>, --export-to <format>
Exports the given score to the specified format (e.g., pdf, png, midi, flac, mp3).
-p, --print
Prints the specified score to the default printer or to the file specified by --output.
-r <dpi>, --render-image <dpi>
Renders the score to an image file (PNG by default) at the specified DPI resolution.
-F, --force
Forces overwriting of existing output files without prompting.
--no-gui
Runs MuseScore in headless mode without a graphical user interface, ideal for batch conversions and scripting.
--layout-stretch <factor>
Adjusts the layout stretching factor for rendering or export.
--image-width <width>
Sets the image width for rendering or export.
--image-height <height>
Sets the image height for rendering or export.
--pages <range>
Specifies a range of pages to export (e.g., "1-3", "2,5").
DESCRIPTION
mscore is the command-line interface to MuseScore, a popular open-source music notation software. It allows users to compose, arrange, and playback musical scores. Beyond its graphical user interface, the mscore command facilitates powerful automated tasks such as converting score files between various formats (e.g., .mscz to PDF, MIDI, or image files), printing scores directly, and rendering parts or full scores programmatically. It supports a wide array of musical symbols, instruments, and playback capabilities, making it a versatile tool for musicians, educators, and publishers. The command-line utility is especially useful for batch processing, scripting, and integration into larger workflows, allowing for efficient management of multiple score files without needing to open the full GUI application.
CAVEATS
While mscore offers extensive command-line functionality, it's worth noting:
* Many advanced layout and interactive features are exclusively available through the graphical user interface.
* When running in GUI mode, an X server or similar display environment is typically required.
* The command-line options are numerous and can be highly specific. It's recommended to consult the official MuseScore documentation or experiment with --help
for the most up-to-date and complete list of options.
BATCH PROCESSING EXAMPLES
mscore is highly effective for automating tasks like converting entire directories of .mscz files to PDF or MIDI. For instance, to convert all MuseScore files in a directory to PDF:
for f in *.mscz; do mscore -o "${f%.mscz}.pdf" "$f"; done
SUPPORTED FORMATS
MuseScore supports a vast range of import and export formats, including its native .mscz, MusicXML, MIDI, PDF, PNG, SVG, FLAC, MP3, WAV, and more. This makes mscore a powerful converter for various musical data types.
HISTORY
MuseScore, and thus its command-line interface mscore, was initially created by Werner Schweer in 2002. It was released as open-source software in 2008. Over the years, it has grown significantly in popularity and features, becoming a leading free and open-source music notation program. The command-line capabilities have evolved to support increasingly complex batch operations and scripting needs, reflecting its broad adoption by musicians and developers alike.