Plugins

Atualizado 3 meses atrás
This page shows old instructions for MuseScore 3.
For MuseScore 4 users, see Plugins.

    Not to be confused with VST and VSTi. VST support is added in Musescore 4, Musescore 3 does not support VST.
    Visit Developers' Handbook Plugins for 3.x Chapter for step by step guide to write a new plugin or edit a current one.

    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.

    Installing a new plugin

    1. Search for available plugins at, for example:
    2. Make sure it is compatible with version of Musescore used.
    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 this 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 Edit → Preferences:General tab window, see Preferences chapter. The default directories are
      • Windows: %HOMEPATH%\Documents\MuseScore3\Plugins
      • macOS: ~/Documents/MuseScore3/Plugins
      • Linux:~/Documents/MuseScore3/Plugins

    Note: (1) The folder name "Plugins" is translated according to Musescore's language setting, see Preferences:General chapter. (2) Some plugins require installing other components such as a specialized Font file.

    Enabling and disabling plugins

    1. Click Plugins: Plugin Manager
    2. Tick a plugin to enable it.

      Plugin manager

    Running a plugin

    Select Plugins → [The plugin name]

    To assign a keyboard shortcut to a plugin, use the Plugin Manager.

    Creating a plugin

    One way to create and edit a plugin is using Musescore's Plugin Creator window, but see the developers' handbook Plugin documentation chapter. That chapter contains coding tutorials and code boilerplates.

    • Click Plugins → Plugin Creator.

    Plugin creator

    Pre-installed plugins

    Some plugins come pre-installed with MuseScore. They are not enabled by default, see "Enabling and disabling plugins" section. They are available at MuseScore repository https://github.com/fp22june/MuseScoreTag362/tree/master/share/plugins.

    • ABC Import :
      This plugin imports ABC text from a file or the clipboard and converts it to MusicXML with Wim Vree's abc2xml Python script. Internet connection is required, because it uses an external web-service at https://abc2xml.appspot.com/ for the conversion. As of June 2023, the pre-installed ABC Import plugin does not work anymore due to expiration of web domain. Working alternatives:

    • Color Notes: Notes → Color Notes .
      Colors notes in the selected range (or the entire score), depending on their pitch. It colors the note head of all notes in all staves and voices according to the Boomwhackers convention. Each pitch has a different color. C and C♯ have a different color. C♯ and D♭ have the same color.
      To color all the notes in black, just run that plugin again (on the same selection), or use Remove Notes Color plugin.
    • Create Score :Creates a new score. It creates a new piano score with 4 quarter notes: C, D, E, F. It's a good start to learn how to make a new score and add notes from a plugin.
    • helloQml : Demonstrates some basic tasks.
    • Note Names : Notes → Note Names. This plugin names notes in a selected range or for the entire score. It displays the names of the notes (as staff text) according to MuseScore's language settings: voices 1 and 3 notes above the staff; voices 2 and 4 notes below the staff; and chord notes in a comma separated list, starting with the top note.
    • Panel : This demo plugin creates a GUI panel.
    • random/random2 : Creates a random score.
    • run : This demo plugin runs an external command. Probably this will only work on Linux.
    • scorelist : This test plugin iterates through the score list.
    • ScoreView : Demo plugin to demonstrate the use of a ScoreView
    • Walk : This test plugin walks through all elements in a score

    Pre-installed plugins are in the folder:

    • Windows: %ProgramFiles%\MuseScore 3\Plugins (or %ProgramFiles(x86)%\MuseScore 3\Plugins for the 32-bit versions) and in %LOCALAPPDATA%\MuseScore\MuseScore 3\plugins on Windows 7 and later
    • macOS: /Applications/MuseScore 3.app/Contents/Resources/plugins (to reveal files in the app bundle, right-click on MuseScore 3.app and choose "Show package contents"), and in ~/Library/Application Support/MuseScore/MuseScore 3/plugins.
    • Linux: /usr/share/mscore-3.x/plugins and in ~/.local/share/data/MuseScore/MuseScore3/plugins. These folders should not be modified. The directory names might be different depending on language setting of the operating system.

    See also

    Do you still have an unanswered question? Please log in first to post your question.