Plugins

Aktualizováno před před 6 měsíci

    What are Plugins?

    Plugins are small pieces of software that add a particular feature to MuseScore. By enabling a plugin, a new menu option is appended to the Plugins menu: subsequently, when this option is selected, the plugin performs a particular task in the score.

    Some plugins come pre-installed with MuseScore—see Plugins installed by default (below). You can find many more plugins in the plugin repository: some work with MuseScore 3, others only with older versions of MuseScore, and some work with either. To tell one from the other: MuseScore 3.x and 2.x plugin code files have an extension of .qml; for older versions, it is .js.

    Installation

    Note: Some plugins may require the installation of other components (fonts, e.g.) to work. Check the plugin's documentation for more information.

    Most plugins are provided as ZIP archives: download the plugin's .zip file and uncompress (unzip) it to one of the directories mentioned below (depending on your OS). If the plugin is provided directly as an uncompressed .qml file, simply download it and place into one of the same directories.

    Once a plugin is installed, it needs to be enabled in the Plugin Manager in order to use it—see Enable/disable Plugins.

    Windows

    MuseScore looks for pre-installed plugins in %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.

    New plugins should not be installed in the above folders, and neither should the folders be modified. Instead add new plugins to %HOMEPATH%\Documents\MuseScore3\Plugins; alternatively, specify a different folder to look for plugins in MuseScore's Preferences.

    macOS

    On macOS, MuseScore looks for pre-installed plugins in the MuseScore bundle in /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.

    New plugins should not be installed in the above folders, and neither should the folders be modified. Instead add new plugins to ~/Documents/MuseScore3/Plugins; alternatively, specify a different folder to look for plugins in MuseScore's Preferences.

    Linux

    In Linux, MuseScore looks for plugins in /usr/share/mscore-3.0/plugins and in ~/.local/share/data/MuseScore/MuseScore 2/plugins.

    New plugins should not be installed in the above folders, and neither should the folders be modified. Instead add new plugins to ~/Documents/MuseScore3/Plugins; alternatively, specify a different folder to look for plugins in MuseScore's Preferences.

    Enable/disable plugins

    To be able to access the installed plugins from the Plugins menu, they need to be enabled in the Plugin Manager:

    Plugin manager

    You do this simply by checking the appropriate tick box. This adds the name of the plugin to the list in the Plugins menu.

    Create/edit/run plugins

    It is possible to create new or edit existing plugins and run them via the Plugin Creator:

    Plugin creator

    Documentation of all available elements can also be found here.

    Plugins installed by default

    Some plugins come pre-installed with MuseScore, but they are not enabled by default. See Enable/disable plugins (above) to enable plugins.

    ABC Import

    This plugin imports ABC text from a file or the clipboard and converts it to MusicXML. Internet connection is required, because it uses an external web-service for the conversion.

    Notes → Color Notes

    This demo plugin 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). You could also use the 'Remove Notes Color' plugin for this.

    Create Score

    This demo plugin 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

    This demo plugin demonstrates some basic tasks.

    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

    See also

    Stále ještě máte nějaké nezodpovězené otázky? Nejprve se, prosím, přihlašte, abyste mohl položit svoji otázku.