1MSCORE(1)                   MuseScore User Commands                  MSCORE(1)
2
3
4

NAME

6       mscore, musescore - MuseScore 2 sheet music editor.
7
8

SYNOPSIS

10       mscore [OPTIONS] [FILE...]
11       musescore [OPTIONS] [FILE...]
12
13

DESCRIPTION

15       MuseScore  is  a  free  and open source WYSIWYG program for typesetting
16       musical scores, released under the GNU General Public Licence (GPLv2).
17
18
19
20
21
22   Getting help
23       This manual documents command line useage of mscore.  For help with the
24       full MuseScore program see:
25
26              Online Handbook
27                     <https://musescore.org/handbook>
28
29              Support Forum
30                     <https://musescore.org/forum>
31
32
33   Further information
34       These pages cover the topics in this manual and may be more up-to-date:
35
36              <https://musescore.org/handbook/command-line-options-0>
37              <https://musescore.org/handbook/revert-factory-settings-0>
38
39

OPTIONS

41       A  summary of options is included below. Running mscore without options
42       launches the full MuseScore program and opens any specified files.
43
44
45
46
47       -h, --help
48              Displays help.
49
50       -v, --version
51              Displays MuseScore's current version in the command line without
52              starting the graphical interface.
53
54       --long-version
55              Displays MuseScore's current version and revision in the command
56              line without starting the graphical interface.
57
58       -d, --debug
59              Starts MuseScore in debug mode.
60
61       -L, --layout-debug
62              Starts MuseScore in layout debug mode
63
64       -s, --no-synthesizer
65              Disables the integrated software synthesizer
66
67       -m, --no-midi
68              Disables MIDI input
69
70       -a, --use-audio <driver>
71              Use audio driver: jack, alsa, pulse, portaudio
72
73       -n, --new-score
74              Starts with the new score wizard regardless of  preference  set‐
75              ting for start mode
76
77       -I, --dump-midi-in
78              Displays all MIDI input on the console
79
80       -O, --dump-midi-out
81              Displays all MIDI output on the console
82
83       -o, --export-to <filename>
84              Exports  the  currently opened file to the specified <filename>.
85              The file type depends on the  filename  extension.  This  option
86              switches to the "converter" mode and avoids any graphical inter‐
87              face. You can also add a filename before the -o if you  want  to
88              import  and  export  files  from  the  command line. For example
89              mscore -o "My Score.pdf" "My Score.mscz"
90
91       -r, --image-resolution <dpi>
92              Determines the output resolution for the output to "*.png" files
93              in the converter mode. The default resolution is 300 dpi.
94
95       -T, --trim-margin <margin>
96              Trims  exported  PNG and SVG images to remove surrounding white‐
97              space around the score. The specified number of pixels of white‐
98              space  will  be  added  as a margin; use 0 for a tightly cropped
99              image. For SVG, this option works only with single-page scores.
100
101       -x, --gui-scaling <factor>
102              Scales the score display and other GUI elements by the specified
103              factor, for use with high resolution displays.
104
105       -S, --style <style>
106              Loads a style file; useful when you convert with the -o option
107
108       -p, --plugin <name>
109              Execute the named plugin
110
111       --template-mode
112              Save template mode, no page size
113
114       -F, --factory-settings
115              Use only the standard built-in presets or "factory-settings" and
116              delete preferences
117
118       -R, --revert-settings
119              Use only the standard built-in  presets  or  "factory-settings",
120              but do not delete preferences
121
122       -i, --load-icons
123              Load  icons from the file system. Useful if you want to edit the
124              MuseScore icons and preview the changes
125
126       -e, --experimental
127              Enable experimental features. (E.g. layers).
128
129       -c, --config-folder <pathname>
130              Set config path
131
132       -t, --test-mode
133              Enable Test Mode
134
135       -M, --midi-operations <file>
136              Specify MIDI import operations file
137
138       -w, --no-webview
139              No web view in Start Center
140
141       -P, --export-score-parts
142              Used with -o .pdf, export score and parts
143
144

FILES

146       Advanced users can find MuseScore's configuration files at:
147
148              ~/.config/MuseScore/MuseScore2.ini
149                     Main MuseScore preference file.
150
151
152              ~/.local/share/data/MuseScore/MuseScore2/
153                     Directory for all other  preferences  and  session  data.
154                     (Autosaves, palettes, locale, plugin data, etc.)
155
156       The  information in these files may allow partial recovery of lost work
157       in some situations, but full recovery is extremely unlikely.  No method
158       of data rescue can match regular, automated backups.
159
160

BUGS

162       Please report any bugs via the Issue Tracker:
163
164              <https://musescore.org/project/issues>
165
166
167       Please check first to if the bug has already been reported. If you just
168       need
169              help with something then please use the support forum instead.
170
171

AUTHOR

173       The MuseScore Team.
174
175
176
177https://musescore.org/         14th January 2016                     MSCORE(1)