.\"                                      Hey, EMACS: -*- nroff -*-
.\" To preview the page formatting without installing use "man -l mscore.1"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH MSCORE 1 "4th June 2015" https://musescore.org/ "MuseScore \- Create, play and share sheet music!"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
.SH NAME
\fBmscore\fP \- MuseScore sheet music editor.

MuseScore is a free and open source WYSIWYG typesetting program for musical scores, released under the GNU General Public Licence.

.SH SYNOPSIS
.B mscore
.RI [ options ]
.RI [ filename(s) ]

\fBMuseScore\fP or \fBmusescore\fP is set as an alias for \fBmscore\fP on some systems.

.SH DESCRIPTION
This manual page documents command line useage of \fBmscore\fP. See also:

    <https://musescore.org/handbook/command-line-options-0>

For help with the full MuseScore program see the Online Handbook:

    <https://musescore.org/handbook>

.SH OPTIONS
A summary of options is included below. Running \fBmscore\fP without options
launches the full MuseScore program and opens any specified file(s).

.TP
.B \-v
Displays MuseScore's current version and revision number in the command line without starting the graphical interface.
.TP
.B \-d
Starts MuseScore in debug mode.
.TP
.B \-L
Starts MuseScore in layout debug mode.
.TP
.B \-s
Disables the integrated software synthesizer.
.TP
.B \-m
Disables MIDI input.
.TP
.B \-a <driver>
Use audio driver: jack, alsa, pulse, portaudio.
.TP
.B \-n
Starts with the new score wizard regardless of preference setting for start mode.
.TP
.B \-I
Displays all MIDI input on the console.
.TP
.B \-O
Displays all MIDI output on the console.
.TP
.B \-o <filename>
Exports the currently opened file to the specified <filename>. The file type depends on the filename extension. This option switches to the "converter" mode and avoids any graphical interface. You can also add a filename before the \-o if you want to import and export files from the command line. For example mscore "My Score.mscz" \-o "My Score.pdf".
.TP
.B \-r <dpi>
Determines the output resolution for the output to "*.png" files in the converter mode. The default resolution is 300 dpi.
.TP
.B \-T <margin>
Trims exported PNG and SVG images to remove surrounding whitespace around the score. The specified number of pixels of whitespace will be added as a margin; use 0 for a tightly cropped image. For SVG, this option works only with single\-page scores.
.TP
.B \-x <factor>
Scales the score display and other GUI elements by the specified factor, for use with high resolution displays.
.TP
.B \-S <style>
Loads a style file; useful when you convert with the \-o option.
.TP
.B \-p <name>
Execute the named plugin.
.TP
.B \-F
Use only the standard built\-in presets or "factory\-settings" and delete preferences.
.TP
.B \-R
Use only the standard built\-in presets or "factory\-settings", but do not delete preferences.
.TP
.B \-i
Load icons from the file system. Useful if you want to edit the MuseScore icons and preview the changes.
.TP
.B \-e
Enable experimental features.
.TP
.B \-c <pathname>
Set config path.
.TP
.B \-t
Enable Test Mode.
.TP
.B \-M <file>
Specify MIDI import operations file.
.TP
.B \-w
No web view in Start Center.

.br
.SH AUTHOR
MuseScore was written by Werner Schweer and others. If you find any bugs in the latest version please report them via the Issue Tracker:

    <https://musescore.org/project/issues>

This manual page is maintained by the MuseScore development team. Please report mistakes via the Issue Tracker.