MuseScore 4 supports all the major screen readers on each operating system. However, MuseScore's support for JAWS is not currently as good as it is for Narrator or NVDA on Windows.
Screen Reader | Availability | Modifier key | On/off shortcut | Settings shortcut |
---|---|---|---|---|
Narrator | Built into Windows | Narrator = Caps Lock | Windows+Ctrl+Enter | Windows+Ctrl+N |
NVDA | For Windows, free | NVDA = Insert / Caps Lock | Off only: NVDA+Q Toggle speech: NVDA+S |
NVDA+N |
JAWS | For Windows, paid | JAWS = Insert / Caps Lock | Off only: JAWS+F4 | JAWS+J |
If speech isn't working in MuseScore, try pressing Alt+F to focus the File menu, then press Esc twice to return to where you were in the app, at which point the screen reader should start working again. This tends to be needed if you start the screen reader after MuseScore is already running.
As mentioned above, MuseScore's speech output with JAWS is not currently as complete as it is with Narrator or NVDA.
Screen Reader | Availability | Modifier key | On/off shortcut | Settings shortcut |
---|---|---|---|---|
VoiceOver | Built into macOS | VO = Ctrl+Option / Caps Lock | Cmd+F5 | VO+F8 |
VoiceOver's Quick Nav mode must be turned off while using MuseScore 4. You can toggle Quick Nav on or off by pressing the Left and Right arrow keys simultaneously while VoiceOver is running. It's also possible to disable Quick Nav from within VoiceOver Utility > Commanders.
MuseScore's interface is navigable with the tab cursor as well as with VoiceOver's own cursor. In general it's best to use the tab cursor because this matches the interface on other platforms, hence is what you will find described in most documentation and tutorials. When using the tab cursor, remember to use the arrow keys as well as Tab as described in Navigating the UI. VoiceOver's cursor can be used to reach areas of the application that are not yet accessible to the tab cursor.
Screen Reader | Availability | Modifier key | On/off shortcut | Settings shortcut |
---|---|---|---|---|
Orca | Built into Linux GNOME | Orca = Insert / Caps Lock | Super+Alt+S | Orca+Space or run orca --setup |
On Linux it is necessary to start the screen reader running before you launch MuseScore, otherwise accessibility features will be disabled to save system resources (the same is true for all Qt applications on Linux). If you forget to do this, simply exit MuseScore and launch it again, this time with the screen reader running.
Orca is the most feature-complete screen reader available for Linux. Orca is built into the GNOME desktop environment, so it's recommended that Linux users with accessibility needs use a distribution based on GNOME or one of its derivatives.
MuseScore 4's UI (user interface) has a hierarchical system of keyboard navigation, which is different to what you may be used to in other applications, including previous versions of MuseScore. In the new system, you must remember to use the arrow keys in addition to the tab key, because the tab key no longer visits every control. This allows for much faster navigation than the traditional system that uses the tab key for all navigation.
Shortcut | Action |
---|---|
F6 and Shift+F6 |
Move to next or previous UI section (e.g. from the toolbars to the palettes and back). The ` key (backtick or grave accent) can be used as an alternative to F6. ` is found above Tab on most QWERTY keyboards, or next to the left Shift key on UK Mac keyboards. |
Tab and Shift+Tab |
Move to next or previous control group (e.g. navigate between toolbars). |
Up Down Left or Right arrow keys |
Move to next or previous control within the current group (e.g. navigate between buttons in a toolbar). |
Enter or Return | Activate the current control (e.g. press a button, or insert an element from the palettes). Spacebar can also be used to activate controls, unless the control is a selectable item in a list. |
Spacebar | Select an item in a list (e.g. an element in the palettes). Once selected, some items can be deleted by pressing Delete, or modified by navigating to other controls in the UI. This approach can be used in the Instruments panel to reorder or remove the instruments in your score. |
Please note that the UI navigation shortcuts are fixed and cannot be changed, unlike the shortcuts for score navigation, which can be customized in Preferences.
Navigation within the score (i.e. inside the "Notation view") is much the same as it was in MuseScore 3. The following shortcuts are of particular value to accessibility users:
Shortcut | Action |
---|---|
Alt+Right and Alt+Left | Move to next or previous element. These shortcuts enable you to visit all kinds of notation elements, not just notes and rests. |
Alt+Up and Alt+Down | Move to note above or below. These shortcuts enable you to move between individual notes in a chord, and also to reach notes and rests in other voices and in other staves. |
F2 or Alt+Shift+E | Edit selected element. This is the keyboard equivalent of double-clicking on an element with the mouse. It enables you to edit text objects, including lyrics, dynamics, and tempo markings. It also enables you to adjust the length of line elements such as hairpins, slurs, and voltas (use the Tab key to change which end of the line you are adjusting). When you have finished editing, press Esc to return to Normal mode. |
Menu or Shift+F10 | Open context menu for selected element(s). This is the keyboard equivalent of right-clicking on an element. It provides access to various options that depend on the element selected. Use this shortcut on a range selection to provide access to Measure properties, and Staff/Part properties. |
Other aspects of keyboard navigation are described on pages throughout this handbook. All score navigation and manipulation shortcuts can be customized in Preferences.
The following accessibility tutorials are designed to get you up and running with MuseScore, using your keyboard and screen reader. They don't cover every aspect of the program, but they should give you a solid foundation that will enable you can take full advantage of the rest of this Handbook.
Video | Topics covered |
---|---|
Installing MuseScore | Installation of MuseScore on Windows, including Muse Hub and Muse Sounds. The process is similar on macOS and Linux, although on Linux you need to install Muse Hub and MuseScore separately. |
Score setup | Initial score setup, including choosing instruments, key signature, time signature, and other settings. |
Entering music | Basic note input. |
Adding markings | Using the palettes to add markings (e.g. dynamics) to your score. |
The user interface | Main window of the program, so you can understand where all the different panels, toolbars, and controls are, and how to reach them by keyboard. |
The Menu bar in MuseScore 4 contains the following menus:
Keyboard users on Windows and Linux can access these menus by holding the Alt key and pressing a certain letter or number key, known as the mnemonic access key, that is displayed with an underline in the name of the menu item you are looking for. For example, press Alt+F for File followed by Alt+A for Save as. The letters 'F' and 'a' are underlined in the UI while the Alt key is held.
On macOS, MuseScore's menus are part of the system-wide menu bar, which you can navigate to by pressing Ctrl+F2.
Beneath the main menu are three tabs, the first of which is the Home tab. This tab contains the following sections:
Create a new MuseScore account, or login to your existing account. With an active account, you can get technical assistance and report bugs in the forums at musescore.org. You can also save your files to the cloud on musescore.com.
This section allows you to set up a new score, or to open an existing one. Learn about creating new scores in Setting up your score.
This window displays a list of available plugins. See the chapter on Plugins to learn about managing these useful add-ons.
This is where video tutorials are hosted. Clicking on any video tutorial opens it on the official MuseScore YouTube channel.
This area is where you do most of your work in MuseScore, including adding music notation and listening to the playback of your score. The workspace consists of several regions (numbered according to labels in the below diagram):
Keyboard users can use the Tab key or F6 to navigate between these UI regions via the keyboard. Within each region, navigation is performed with the arrow keys and Tab.
Almost all panels and toolbars can be un-docked and repositioned according to your project requirements and workflow preferences. Learn more about this in Workspaces.
This tab allows you to view your score without the clutter of the note input toolbar or sidebar panels. There are options to print the score, and to export it in a variety of image, audio and document formats. When your score is finished, you can also publish it to musescore.com.
In certain parts of the application, primarily in the Score tab, context menus are available with additional functionality, such as options to copy, edit, customise, delete, or view the properties of whatever item(s) were selected at the time you opened the menu.
Within the score, every element has a context menu. To open the context menu for a particular element, right-click on the element with the mouse, or select the element via the keyboard and press Shift+F10 (some PC keyboards also have a dedicated Menu key near to the right Ctrl key). The exact options available in the context menu can differ depending on the type of element you selected, so it is worth experimenting to find out what options are available for different kinds of elements. For example, when you right-click on an empty region within a measure the resulting context menu contains options for Staff/Part properties and Measure properties. This is currently the only way to get to those options and the dialogs they lead to.
Outside of the score, the presence of a context menu is often indicated by a small button with three dots, or by a settings cog. Press the button to open the menu. Sometimes the button is associated with another item in the vicinity, such as in the Palettes, where there is three-dots button for each palette. In this case you can right-click on the palette name, or select it with the keyboard and press the Shift+F10 or Menu key shortcut, as an alternative to using the three-dots button.
Scrollbars appear at the right-hand and bottom edges of the score view. Click and drag them to quickly move the score view up and down, or left and right. Scrollbars are usually hidden from view, but can be revealed by hovering over the edge of the score view with your mouse.
You can also scroll the score using the PgUp, PgDn, Home, and End keys on your keyboard. If your keyboard lacks dedicated keys for these functions, most systems will also allow you to access these functions by holding Fn or a similar key, then pressing Up, Down, Left, or Right respectively.
By themselves, PgUp and PgDn scroll one screenful at a time. This may be less than an actual page of your score. If you hold Ctrl (Mac: Cmd) while pressing PgUp or PgDn, it moves a full page at a time.
When a single element is selected in your score, it acts as a cursor. You can change the selection—and thus move the cursor—using common keyboard shortcuts.
The Left and Right keys will move horizontally through your score one note or rest at a time. If you hold Ctrl (Mac: Cmd) while pressing Left or Right, you can navigate a full measure at a time.
To move the cursor vertically through the various notes, voices, and staves in your score, use the shortcuts Alt+Up and Alt+Down (Mac: Option+Up and Option+Down).
You can also use the shortcuts Alt+Left and Alt+Right (Mac: Option+Left and Option+Right) to select elements other than notes or rests. These commands allow you select almost any elements—including articulations, barlines, hairpins, and more—using the keyboard alone.
In addition, Ctrl+Home (Mac: Cmd+Home) will select the first element in your score, and Ctrl+End (Mac: Cmd+End) will select the last element. Again, for keyboards that lack dedicated Home and End keys, most systems provide the alternative of Fn+Left and Fn+Right respectively.
See Default keyboard shortcuts to learn more.
The Navigator is a panel that displays thumbnails of score pages. To view or hide the Navigator, click View → Navigator.
The blue bounding box represents the area of the score currently in focus in the score view. Click on the box and drag it to move around your score.
A navigation aid that shows instruments and score structure. For details, see Timeline.
You can switch between different views of the score using the pop-up in the right-hand side of the status bar.
The score is shown as it will appear when printed or exported as a PDF or image file: that is, page by page, with margins. MuseScore applies system (line) and page breaks automatically, according to the settings made in Page settings and Style. In addition, you can apply your own system (line), page or section breaks.
The score is shown as one unbroken system. Even if the starting point is not in view, measure numbers, instrument names, clefs, time and key signatures will always be displayed on the left of the window.
The score is shown as a single page with a header but no margins, and with an infinite page height. System (line) breaks are added automatically, according to the settings made in Page settings and Style. In addition, you can apply your own system (line) or section breaks.
There are several ways to zoom the score in or out:
Ctrl++ (Mac: Cmd++)
or scroll up with the mouse scroll wheel while holding Ctrl (Mac: Cmd).
Ctrl+- (Mac: Cmd+-)
or scroll down with the mouse scroll wheel while holding Ctrl (Mac: Cmd).
To zoom in and out of your score from the Status bar controls:
This restores the zoom to the default (100%) level.
Ctrl+0 (Mac: Cmd+0)
The Find/Go to panel allows you to speedily navigate to a specific measure, rehearsal mark or page number in the score.
To show the panel:
To hide the panel:
Enter the measure number (counting every measure, starting with 1, irrespective of pickup measures, section breaks or manual changes to measure number offsets).
Enter the page number using the format pXX (where XX is the page number).
Enter the number using the format rXX (where XX is the number of the rehearsal mark).
Enter the name of the rehearsal mark (the search is not case sensitive).
Pro tip! It is best to avoid naming rehearsal marks with the single letters “R", “r", “P”, “p", or one of these letters with an integer (e.g. “R1” or “p3”), as this can confuse the search algorithm.
Timeline is a navigation aid that displays at the bottom of the program window, giving you an overview of the instruments and main structural elements measure-by-measure. You can easily move about the score by clicking on a measure or a structural element.
There are four parts to the timeline:
This is found in the top left corner of the timeline. These are the names of the meta rows.
This is found in the bottom left corner of the timeline. These are the names of the rows in the main grid.
This is found in the top right corner of the timeline. These hold the meta values of the score.
This is found in the bottom right corner of the timeline. This holds multiple 'cells' (a specific measure and staff in the score represented as a square)
Meta elements are those found in the score that are not notes, but are still important to the score—such as key signature, time signature, tempo, rehearsal marks, bar lines, and jumps and markers.
To select a measure in the timeline, press the mouse button on the cell. A blue box will appear around the selected cell and the respective measure in the score will be selected. The score view will place the selected measure in view.
Holding Shift and holding the left mouse button and dragging the mouse over the main grid will create a selection box. Upon releasing the mouse button, all the cells underneath the selection box will be selected, as well as all the measures in the score.
If a cell is already selected, holding Shift and selecting another cell in the timeline will stretch the selection to that new cell, similar to how the score does
If no cells are currently selected, holding Ctrl and selecting a cell will select the entire measure
To clear selection, holding Ctrl and clicking anywhere on the grid or the meta rows will clear any current selection.
Selecting the meta values on the timeline will attempt to select the respective meta values in the score.
Scrolling the mouse wheel up or down will move the grid and instrument labels down or up respectively. The meta labels and rows do not move.
Holding Shift and scrolling the mouse wheel up or down will move the grid and meta rows left or right respectively. The meta labels and instrument labels do not move.
Holding Alt and scrolling the mouse wheel up or down will move the grid and meta rows left or right respectively, faster than Shift scrolling. The meta labels and instrument labels do not move.
To drag the contents of the timeline, hold the left mouse button and move it around.
All meta labels besides the measures meta may be rearranged in any way. By moving the mouse cursor onto one of the meta labels, small up and down arrows will appear. Click the left mouse button on the up arrow to swap the meta label with the one above it. Click the left mouse button on the down arrow to swap the meta label with the one below it.
In order to hide all the meta labels while keeping all the meta information on the timeline, click the left mouse button on the measures meta to collapse all the currently visible meta rows into one row, where the meta values are staggered in that row. Click the left mouse button again on the measures meta to expand the meta rows.
All instruments--hidden or not--will be displayed on the timeline. To start this interaction, the mouse cursor is moved over an instrument label. A small eye will appear on the right side of the label that is open if the instrument is visible on the score, and closed if the instrument is hidden. Click the left mouse button on the eye to toggle between the two options.
To zoom in or out of the score, hold Ctrl and scroll the mouse wheel up or down respectively (Mac: Cmd + scroll).
MuseScore 4.1 added a braille panel that displays the current measure in braille music notation. The content is similar to what you get if you export braille via the File menu, but the braille panel updates live as you navigate through the score.
As of MuseScore 4.2, the braille panel can be used to enter notes and some musical symbols using Perkins-style 6-key braille input.
The contents of the braille panel can be displayed on a braille terminal connected to your computer (e.g. via Bluetooth or USB).
The following limitations apply when using a physical braille display:
Please let us know in the Documentation forum if you discover a way to bypass any of these limitations.
On this page, we refer to MuseScore's ordinary stave notation as "print music". This is the traditional music notation that sighted musicians use on paper or electronic devices, and is displayed in the central region of MuseScore's main window, known as the score view.
Braille can also be used on paper, but it's not printed with ink. Instead, it's embossed as raised dots, which blind musicians read by touch. It is common in accessibility circles to use the word "print" to mean non-braille notation.
The braille panel appears directly below the score in MuseScore’s main window.
With the braille panel open, press the Tab key while the score has focus. A caret (text cursor) will appear in the braille at the position of whatever element was selected in the score. For example, if a note was selected in the score, the text caret will appear on that note in the braille.
Press Shift+Tab at any time to leave the braille panel and return to the score. The braille panel will remain open so you can navigate to it again with Tab.
While the braille panel has focus, you can move the text caret around using the arrow keys. As the caret moves through the braille, the element to the right of the caret becomes selected in the score. If that element is a note, MuseScore will play the sound of the note.
The braille panel only shows one measure at a time, but it shows that measure for all instruments in the score. Each line of braille corresponds to a staff in the print notation, so grand staff instruments like the piano get two lines of braille, and the organ gets three lines.
If a staff has lyrics, these are written on another line of braille immediately below the line corresponding to that staff. If there are multiple lines of lyrics (e.g. for multiple verses), each line of lyrics is written on a separate line in the braille.
The following keyboard shortcuts are available for navigating the braille.
Action | Windows/Linux | macOS |
---|---|---|
Go to next braille cell | Right | Right |
Go to previous braille cell | Left | Left |
Go to braille line above | Up | Up |
Go to braille line below | Down | Down |
Go to next measure | Ctrl+Right | Cmd+Right |
Go to previous measure | Ctrl+Left | Cmd+Left |
Go to beginning of score | Ctrl+Home | Cmd+Fn+Left |
Go to end of score | Ctrl+Emd | Cmd+Fn+Right |
Toggle braille input mode on/off | N | N |
Notes and certain musical symbols can be entered in the braille panel using a 6-key method of braille input similar to that of the Perkins Brailler.
While the braille panel has focus, press N to toggle braille input mode on or off.
While in braille input mode, six letter keys on the computer keyboard are used to represent the six braille dots that make up a single braille cell (⠿).
The keys used are F, D, S for dots 1, 2, 3 down the first column of the cell, and J, K, L for dots 4, 5, 6 down the second column. The Space key is used to represent an empty braille cell (⠀), sometimes referred to as dot 0.
Up to six of these keys can be pressed in combination to construct any pattern of raised dots. For example, to enter a quarter note C, which in braille is ⠹ (i.e. dots 1, 4, 5, 6), press and hold F+J+K+L, then release these keys to confirm the pattern. The keys can be pressed and released in any order, providing at least one key is held at all times, until you have completed the pattern.
When the final key is released, MuseScore reads your braille pattern. If your pattern corresponds to a recognized note or musical symbol then this element is entered directly in the score, not in the braille panel, because print notation is the "ground truth" for MuseScore. Once the element is in the score, the braille panel automatically updates to reflect this change.
Sometimes in music braille, the same information can be expressed in multiple ways. For the sake of consistency, MuseScore always picks the same way regardless of how you entered the notation. Therefore, the braille that appears in the braille panel may not exactly match the pattern(s) you entered with the six keys, though it will have the same meaning.
In braille, eighth notes (quavers) and 128th notes are written as:
Note | Braille | Dots | Keys |
---|---|---|---|
C | ⠙ | 1, 4, 5 | F+J+K |
D | ⠑ | 1, 5 | F+K |
E | ⠋ | 1, 2, 4 | F+D+J |
F | ⠛ | 1, 2, 4, 5 | F+D+J+K |
G | ⠓ | 1, 2, 5 | F+D+K |
A | ⠊ | 2, 4 | D+J |
B | ⠚ | 2, 4, 5 | D+J+K |
Additional dots are added to the above sequences to create other durations:
Duration | Braille | Dots added | Keys added |
---|---|---|---|
Quarter (crotchet) and 64th notes | ⠠ | 6 | L |
Half (minim) and 32nd notes | ⠄ | 3 | S |
Whole (semibreve) and 16th notes | ⠤ | 3, 6 | S+L |
Hence a quarter note C is ⠹ (dots 1, 4, 5, 6) and is entered with F+J+K+L. This pattern is also used for a 64th note C.
As mentioned above, 16th notes and smaller use the same dot patterns as larger durations. When reading braille, you can work out whether the shorter or longer duration is being specified by looking at the time signature as well as other notes in the measure. However, when writing braille, you need to tell MuseScore which durations you want to use.
⠤ | ⠄ | ⠠ | ⠀ | Dots to select | Keys to select | |
---|---|---|---|---|---|---|
Group 1 | whole | half | quarter | eighth | 0, 1 | Space+F |
Group 2 | 16th | 32nd | 64th | 128th | 0, 2 | Space+D |
By default, MuseScore enters group 1 durations (whole, half, quarter, eighth). To switch to group 2, enter dots 0, 2 (i.e. press Space+D). Nothing will appear in the braille panel, but any notes or rests you write from now on will be in group 2 (16th, 32nd, 64th, 128th). To switch back to group 1 durations, enter dots 0, 1 (i.e. press Space+F).
It's not currently possible to enter durations of 256th and smaller, or breve (double whole) and larger, via the braille panel.
Braille uses ⠄(dot 3) to represent an augmentation dot, which is added in a new braille cell immediately following a note. No other cells are allowed to come between the note and its augmentation dot.
To create a dotted note in the braille panel, first write the main note duration using the rules above, then follow it with dot 3 (i.e. press S).
For example, a dotted quarter note C is ⠹⠄, which can be stated as dot pattern 1456-3, where the dash means to start a new cell. In terms of keys, this is F+J+K+L, S.
It's not currently possible to enter multiple dot 3s to create double and triple dotted notes via the braille panel.
Octave marks in braille serve a similar purpose to clefs in print music. If you see a note in print, you don't know what pitch it is until you look at the preceding clef. In braille, if you see ⠙ (dots 1, 4, 5) then you know the note is a C, but it could be a C in any octave. To determine the octave, you need to look at the preceeding octave mark (and also at any notes between that octave mark and the current note).
A standard 88-key piano has 7 complete octaves. Starting on the lowest C, which is called C1 in braille as well as in scientific pitch notation, the first complete octave of white notes is C1, D1, E1, F1, G1, A1 and B1. After B1 comes C2, which is the start of the second complete octave. This scheme continues up to the final complete octave, which starts with C7 and ends with B7.
In this system, C4 is middle C, and A4 is "concert A" (i.e. the note that the orchestra tunes to at the start of a performance). Enharmonic spelling is important, so B♯3 sounds the same as C4 despite being notated in a different octave, and C♭4 sounds the same as B3.
Even standard 88-key pianos have a few notes outside the range C1 to B7. Braille refers to the C0 octave as the "sub" octave, and the C8 octave as the "super" octave. These simply double the markings used for the first and seventh octaves.
Octave | Marks | Dots | Keys |
---|---|---|---|
0 (sub) | ⠈⠈ | 4-4 | J, J |
1 | ⠈ | 4 | J |
2 | ⠘ | 45 | J+K |
3 | ⠸ | 456 | J+K+L |
4 (middle) | ⠐ | 5 | K |
5 | ⠨ | 46 | J+L |
6 | ⠰ | 56 | K+L |
7 | ⠠ | 6 | L |
8 (super) | ⠠⠠ | 6-6 | L, L |
When specified, octave mark are placed immediately prior to a note. So a middle C quarter note is ⠐⠹, or dots 5-1456, which is entered as K, F+J+K+L. No other cells are allowed to go between the octave mark and the note it belongs to.
Octave marks don't have to be given before every note. Octave marks are only required for the: