Overview

MuseScore works with your "System" language (the one used for most programs, and generally depending on your country and the language settings of the PC, or account).

Change language

1. From the menu, select Edit→Preferences... (Mac: MuseScore→Preferences...);

2. In the General tab, select the desired language from the drop-down list in the Language section:

   

Update translations

To update translation(s):

1. From the menu, select Edit→Preferences... (Mac: MuseScore→Preferences...);
2. In the General tab, click on the Check for language updates button;

A message which displayed if the version of your language is already up to date, if not then the update will be downloaded.

To complete this step, a restart of the application is required.

See also

• Helping with translations

Overview

To change the appearance of MuseScore

1. From the menu, select Edit→Preferences... (Mac: MuseScore→Preferences...);

2. In the Appearance tab, select the desired option described below.

   

Theme and Colors

The following options are available to change the colors of MuseScore. The display changes immediately so options can be tested without closing the dialog. The changes apply to all open instances of MuseScore (see Windows)

• Light or Dark Theme
• Select "Follow system theme" if you want MuseScore to change themes from light to dark, or dark to light, when the system theme changes
• Enable high-contrast
• Accent color options
• Background - the color behind the score (not the color of palettes and other program items) can be changed to a solid color or a Wallpaper image.
• Paper - the color of the score itself can be changed to a solid color or a Wallpaper image.
• Invert Score - swaps the color of score elements with the Paper color

Fonts

To change the font face and text size for Menu and Palette elements:

1. From the menu, select Edit→Preferences... (Mac: MuseScore→Preferences...);
2. In the Appearance tab, select the font options.

This does not affect and text elements in the score.

Overview

Windows, toolbars and panels within MuseScore can be repositioned, and you can choose which elements you want to see displayed in them.

The default appearance of MuseScore is shown below:

1. The Menu bar
2. Toolbars
3. Palette, Property and Instrument Panels
4. The Score Window
5. The Status Bar

Toolbars

Showing and hiding toolbars

To show or hide the playback controls, note input toolbar, or the status bar:

• Select View→Toolbars... and check/uncheck the applicable element.

Rearranging toolbars

To change the position of either the note input or playback toolbars, click on and hold the six dots at the left of the toolbar, then drag and drop it to the desired location. The toolbar can be left free floating, but in the case of the note input toolbar, you can also drag and drop it either to the left or the bottom edge of the program window—a blue rectange then appears to show you that you can drop the toolbar at that location to redock it. The playback toolbar can only be redocked in its default position.

Customizing contents of toolbars

To select the icons that you want on view in the note input or playback toolbars, click on the gear icon to the right of the toolbar:

In the case of the note input toolbar, this reveals a dropdown list from which you can hide or display the various icons by clicking on the eye symbol to the left of each one (closed=hidden, open=displayed).

In the case of the playback toolbar, uncheck or check the various options in the gear menu to hide or display the corresponding elements.

Windows and Panels

Docking and undocking panels

To undock and move one of the side panels (Palette, Instruments, Properties, or Selection filter), click on the three dots on the tab, select the Undock option, then drag the undocked panel to the desired position.

You can leave the panel free-standing but there are also dock positions at the top and right hand edges of the document window—a blue rectangle appears to show that you can drop the panel to redock it at that location.

In a similar way, you can redock the free panel back to the sidebar:

• To display half-length at the top of the sidebar, drag and drop the free panel to the top left of the sidebar.
• To display half-length at the bottom of the sidebar, drag and drop the free panel to the bottom left of the sidebar.
• To display full-length in the sidebar, drag and drop the free panel to the center left of the side.

You can also redock the free panel in its original position by clicking on the three dots on the tab, and selecting Dock.

Panels such as the Mixer or virtual Piano can be undocked if desired, by dragging them into position or clicking on the three dots icon and selecting Undock. To redock, click on the three dots icon and select Dock.

The undocked mixer can be resized by dragging the edges inwards or outwards.

Customizing contents of panels

To choose which elements to display within the mixer or the virtual Piano, click on the three dots, select View and uncheck or check the applicable options.

To customize the palettes area, see Customization: Palettes.

Overview

Templates

A template is simply a standard MuseScore file (*.mscz) stored in a dedicated “Templates” folder.

There are two kinds of templates:

• System templates. These are supplied with the installed version of MuseScore and cover a wide variety of solo instruments and ensembles of all genres. When you open the New Score dialog, these template files appear under various categories in the Create from Template tab.

• User templates. These are created by the user and stored in the folder marked Templates in the MuseScore4 folder of your Documents directory. When you open the New score dialog, user templates are displayed in the My Templates section of the Create from template tab.

Style files

A style file is a file containing customized style settings for all musical and text objects in a score. You can save an existing set of styles or import one using the Format menu (see below).

Templates

Saving your score as a template

1. Create a specimen score containing the style settings, workspace, and title text that you wish to use in the template.
2. Make sure that the Title text of the score describes the template accurately, as this is the wording that will appear in the My templates section of the New score dialog.
3. Save the score in the "Template" folder of your MuseScore 4 user directory.

Creating a score from your template

1. Open the New Score dialog
2. Choose a template file in the “My templates” section of the Create from template tab.
3. Complete the rest of the New Score dialog and exit.

Style files

Saving style settings for your score to a file

1. Create a score with the style settings that you wish to save and reuse in future scores
2. Select Format→Save style, and save the Style file in the “Styles” folder of your MuseScore 4 user directory.

Loading style settings into your score from a file

1. Open the score to which you want to apply the saved style settings
2. Select Format→Load style, and select the applicable style file.

Setting a default style for your score

[to be added]

This chapter shows you how to customize the palettes and their contents; the application of palette items is already covered in Using the palettes (Basics).

Adding palettes

To add a preset or a custom palette, see Using the palettes: Adding more palettes.

Hiding and deleting palettes

To hide a preset palette, right click on it and select Hide palette. The palette is returned to the Add Palettes list (see above). Note that preset palettes cannot be deleted.

To hide or delete a custom palette you have created earlier, right click on it and select Hide/Delete palette. Then follow the instructions in the dialog.

Changing the order of palettes

To change the order of a palette simply drag it up or down and drop it onto the desired position in the palettes list.

Customizing palette contents

Palettes can be populated with items from the Master Palette (Shift+F9 or View→Master palette), or from an opened score.

Score items, when added to a palette, are saved with their custom properties.

To enable/disable editing for a particular palette:

1. Right-click on the palette name; or click on the ellipsis symbol (three dots) to the right of the palette name
2. Check/uncheck Enable editing.

Adding elements from the Master Palette window

To add a symbol from the Master Palette to a palette in the Palettes panel:

1. Open the desired palette, make sure editing is enabled (see Customizing palette contents).
2. Open the Master Palette (Shift+F9 or View→Master palette)
3. Drag and drop symbols from the relevant section(s) of the Master palette to the ordinary palette as required.

If you have created a custom palette, there is another way to access the Master Palette:

1. Open the custom palette
2. Click on the More button
3. Use the arrow buttons to navigate through the various sections of the Master Palette window
4. Select on a symbol
5. Press Add to my custom to add it to the custom palette
6. To exit the dialog, click once more on the More button, or press Escape, or click outside the More section.

Adding elements from the score

To add score elements to a palette:

1. Open the desired palette
2. Press Ctrl+Shift (Mac: Cmd+Shift), then drag and drop the score element to the open palette.

Moving elements between palettes

Symbols can be moved from one open palette to another simply by dragging and dropping them.

Deleting elements from palettes

To delete an element in a palette, right-click on it and select Delete. In the case of preset palettes, the element will be moved to the More section. For custom palettes you are offered a choice of Hide (send element to the More section) or Delete permanently.

Resetting a palette

To reset a palette to its default state, right-click on the palette name, or click on the ellipsis symbol (three dots) to the right of the palette name; then select Reset palette.

Note: A custom palette will be reset to an empty palette when this function is applied.

Saving and loading palettes

To save a palette, right-click on the palette name, or click on the ellipsis symbol (three dots) to the right of the palette name; then select Save palette.

To load a previously-saved palette, right-click on a palette name, or click on the ellipsis symbol (three dots) to the right of the palette name; then select Load palette and navigate to the desired palette, select it and click Open.

Palettes menu

To access display options for the palettes area, click on the ellipsis symbol (three dots) to the right of the Palettes title at the top of the palettes area.

• Single-click to open a Palette: Uncheck this if you want to open a palette by double-clicking.
• Open only one Palette at a time: if this option is checked, when you open a palette other palettes automatically close.
• Collapse all Palettes: Closes all open palettes.
• Expand all Palettes: Opens all palettes.
• Close: Palettes panel closes.
• Undock: Undocks the palettes panel. See also Windows and panels.

Palette properties

To access Palette properties for individual palettes, right-click on the palette name, or click on the ellipsis symbol (three dots) to the right of the palette name; then select Palette properties.

This allows you to rename the palette, create a visible grid to separate elements, adjust width and height of cells, and change the scale and offset of the symbols.

See also

• Using the palettes for info about how to apply palette items.
• Other symbols for more info about the Symbols palette.

Overview

Workspace is the visual settings, also known as graphical user interface (GUI), of the Musescore program itself. An analogy to the position of the pen, ruler etc on a composer's desk. It includes the content, docked/undocked status and positions of palettes, toolbars and assorted open panels. Changes made to the current workspace are automatically saved, no further action is required. You can create custom workspaces to quickly change all these settings with a mouse click.

Note that the following settings do not count as workspace. View→Show→ Show visible, Show Invisible, Show formatting, Show Frames, Show Page Margins, Mark irregular measures, and status bar's Concert Pitch, Zoom level, and Page View/Continuous View option. These settings, covered in The user interface chapter, are score data. They are saved to and loaded from each score file. Templates contain these settings and will be used when you create a new score from a template, see Setting up your score.

Creating a new workspace

To create a new workspace:

1. Click on the current workspace name in the status bar below the document window. Alternatively, select View→Workspaces→Configure workspace
2. Click on Create new workspace
3. Fill in the name of the workspace, choose the options it contains so that only these options are loaded and saved when the workspace is used.
4. Click Select to close the dialog.

To customize the palettes display and contents, see palettes.
To customize the display of toolbars and panels, see Toolbars and panels.

Deleting a workspace

1. Click on the current workspace name in the status bar below the document window. Alternatively, select View→Workspaces→Configure workspace
2. Select the workspace to be deleted
3. Click on the trash icon at the top of the dialog.

Switching between workspaces

1. Click on the current workspace name in the status bar below the document window.
2. In the resulting dialog box, click on the desired workspace
3. Press Select.

Alternatively

1. Select View→Workspaces→Configure workspace
2. Click on the desired workspace in the menu.

Overview

MuseScore commands can be accessed via the main menus, toolbars, Properties panel or context menus, or by using keyboard shortcuts.

Pre-existing keyboard shortcut are shown alongside the commands in the main menus or context (right-click) menus, or by hovering the mouse pointer over an icon in a toolbar.

Alternatively, you can view a list of commands and their shortcuts in Edit→Preferences→Shortcuts. This is also the place where you can create a shortcut or change an existing one. To locate a command in the list either scroll down the alphabetical order, or enter an appropriate keyword in the “Search shortcut” box.

Defining a shortcut

To define a new shortcut, or change an existing one:

1. From the menu bar, select Edit→Preferences→Shortcuts
2. Find the relevant command in the alphabetical list; use the Search box if needed.
3. Either double-click the relevant entry, or select the entry and click Define…
4. With the Enter shortcut sequence dialog open, press and hold the sequence of keys on your keyboard to use as the new shortcut.
5. Press Save (or Cancel to exit the dialog without changing anything).

Resetting and clearing shortcuts

To reset a shortcut to its default:

1. From the menu bar, select Edit→Preferences→Shortcuts
2. Find the relevant command in the alphabetical list; use the Search box if needed.
3. Select the entry and press Reset to default.

To clear (i.e. delete) a shortcut:

1. From the menu bar, select Edit→Preferences→Shortcuts
2. Find the relevant command in the alphabetical list; use the Search box if needed.
3. Select the entry and press Clear.

Note: You can select more than one shortcut if needed. Press the Shift key to establish a continuous range, or the Ctrl key for a list.

Importing and exporting shortcuts

To save the existing shortcuts or import a list of your own:

1. From the menu bar, select Edit→Preferences→Shortcuts
2. Press Export to save the list; or Import to load a new shortcut list.

To edit Preferences (the appearance and general behavior of MuseScore), go to Edit→Preferences.

These are divided logically into sections (see below); notice also the three buttons at the bottom of the window:

• Reset preferences: Click on this to reset all preferences to their default values.
• Cancel: Exit preferences without changing anything.
• OK: Exit preferences and apply any user changes.

General

You can specify your language, and autosave interval in “General”. See also Language.

“Program start” allow you to choose what, if any, score you want displayed in the edit window after launching.

“Folders” allows you to customize locations for any user folders (though it’s a good idea to leave them at default to start with if you are a new user).

Appearance

Choose between light and dark options, and specify the accent color; there is also a high contrast option for visually impaired users.

The system font is also the default for the MuseScore UI, but you can alter this if desired—and the font-size.

You can set the score paper/color option and the background. For visually impaired there is an “Invert score” option which inverts the score colors (white to black and vice versa)

Canvas

Specify the default zoom level of the score, and the mouse zoom precision. Also how you want your score pages to scroll, and the degree of precision of mouse selection.

Save & publish

Specify the autosave duration and options relating to generating and publishing audio on musescore.com and audio.com.

Note input

Here you can specify whether to advance to the next note on key release (in MIDI input), whether to color notes outside of an instrument's usable range, whether to play notes when editing (and for how long), and customise how voice assignment for dynamics works.

Score

Customize the default order of instruments for new scores, and default styles for scores and parts.

Audio & MIDI

Specify audio device, buffer size and sample rate, MIDI input and output devices, and customize mixer behaviour.

MIDI mappings

Here you can map certain keys of your external MIDI keyboard to certain actions, for example to start or stop score playback, set note-entry duration, and so on.

Import

Here you can specify a custom style file to use for imported files (MIDI and MusicXML), set the character set for imported binary files, customise MusicXML import, set the shortest note value to use in imported MIDI files, and choose whether to import the layout in MEI files.

For details of the MusicXML options, see Working with MusicXML files.

Shortcuts

See Keyboard shortcuts for more information.

Update

By default MuseScore automatically checks for updates when online. You can turn this off by unchecking the box.

Folders

Specify the default folders for scores, style files, templates, plugins and soundfonts.

Advanced

A number of specialized options can be accessed here, such as voice color, and palette behavior.

Braille

Enable or disable the braille panel, and customize its behavior.

Not to be confused with VST and VSTi.

Overview

A MuseScore plugin is a small piece of software that adds extra functionality to the program. A plugin need to be enabled first, and then executed by using the Plugins menu. Some plugins come pre-installed, they are disabled by default. There are also plugins created and shared by other musicians, anyone can download and use them.

Managing plugins

Installing a new plugin

1. Search for available plugins at, for example:
   • https://musescore.org/plugins [musescore.org→Download→Plugins]
     Warning: Plugins can potentially contain bad or malicious code, which compromise the machine and damage the scores. All plugins shared on musescore.org's plugin repository are unvetted. No warranty of any kind is provided. Users should download from a trusted author or double-check the code themselves. Seek advice on the Plugins forum.
   • https://github.com/topics/musescore-plugin
   • https://github.com/topics/musescore-plugins
2. Make sure it is compatible with Musescore version.
   
3. Download the file:
   • for musescore.org hosted .qml files, sometimes a web browser open it as plain text and refuses to download it as file. In that case, right click on a link and select Save link as...
   • for github.com unpackaged code, download the project as a zip file by clicking Code: Download ZIP
     
   • for github.com packaged release, click on an appropriate item under Assets
     
4. (If it is a zip file) Extract it using an archive extraction software.
5. Move the files to MuseScore's plugins folder, configurable at Preferences:General:Folders. The default directories are
   • Windows: C:\Users\[Your User Name]\Documents\MuseScore4\Plugins\
   • macOS: ~/Documents/MuseScore4/Plugins/
   • Linux: ~/Documents/MuseScore4/Plugins
     
     

Updating an existing plugins

Updating works the same way as installing, but remember to remove the files from the previous version to avoid duplicate plugins!

Enabling and disabling plugins

1. Click Home: Plugins or Plugins: Manage plugins...
   
2. Select a plugin and click Enable or Disable
   

Running a plugin

1. Make sure the Score tab is currently opened.
2. Select Plugins → [The plugin name]
   

To assign a keyboard shortcut a plugin, use Home: Plugins or Plugins: Manage plugins....

Pre-installed plugins

[work in progress, please provide missing info, write brief info on each]

See https://github.com/musescore/MuseScore/tree/master/share/plugins

• Add Courtesy Accidentals
• Color Notes
• Lilypond Lyrics
• Mirror Intervals
• Modal Temperaments
• Modal Tuning
• New Retrograde
• Note Names
• Remove Courtesy Accidentals
• Tuning

Create a plugin

The plugin system of Musescore 4 is currently being redesigned and reimplemented.

As of October 2023, Musescore 4.1.1 plugin system is mostly a somewhat restricted version of the Musescore 3 plugin system. Visit Developers' Handbook Plugins for 3.x Chapter for fundamentals, and Plugins for 4.x Chapter for info on the new parameters and porting a Musescore 3 plugin to MuseScore 4.

See also

• MuseScore 3 features not implemented in MuseScore 4