Published on MuseScore (https://musescore.org)

Install on Linux

    MuseScore packages for various Linux distros are available from the download page. The easiest to install is the AppImage, which can be run on any Linux distribution, but a range of other specialist packages are available if you prefer. Building from source is another possibility.

    AppImage

    AppImages can run on virtually any Linux distribution: all the files needed are contained within the AppImage itself, just like a portable App. The following procedure allows you to run the MuseScore AppImage on your system:

    Step 1: Download

    AppImages come in different versions. Make sure you download the right one for your system. To check the architecture of your system:

    1. Open the Terminal.
    2. Type
        arch
 

    or

        uname -m
 

    The output will be something like "i686", "x86_64" or "armv7":

    Go to the download page and find the AppImage that best matches your architecture. Once downloaded, the file will be named "MuseScore-X.Y.Z-$(arch).AppImage".

    Step 2: Give the file permission to execute

    There are two ways to do this:

    From the File Manager:

    1. Right-click on the AppImage and select "Properties".
    2. Open the "Permissions" tab.
    3. Enable the option labelled "Allow executing file as a program".

    The process may be slightly different in other file managers.

    From the Terminal:

    This command works on all Linux systems (Note: The code below assumes that the AppImage is in the Downloads folder. If not the case then amend the file path accordingly):

        cd ~/Downloads
    chmod u+x MuseScore*.AppImage
 

    Step 3: Run the AppImage

    Note: You can move the AppImage to wherever it is most convenient. And to "uninstall" it, just delete it.

    Install the AppImage

    The above procedure allows you to run the MuseScore AppImage but doesn't integrate it with the rest of your system: it doesn't appear in your App menu, and MuseScore files are neither associated with the program nor do they have the correct icon on them.

    To remedy this, you need to actually install the program as follows:

    1. Open the Terminal.
    2. Type the following (Note: The code below assumes that the AppImage is in the Downloads folder. If not the case then amend the file path accordingly):
        cd ~/Desktop
    ./MuseScore*.AppImage install
 

    Or, alternatively, you can combine the operation into one command:

        ~/desktop/MuseScore*.AppImage install
 

    Use the "--help" and "man" options to get more information about the available command line options:

        ./MuseScore*.AppImage --help   # displays a complete list of command line options
    ./MuseScore*.AppImage man      # displays the manual page (explains what the options do)
 

    Distribution Packages

    Debian

    (Ideally before, otherwise while or after) installing MuseScore itself, you can install one or more soundfont packages (if none is installed, the dependencies will pull in a suitable soundfont automatically):

    Note: only the MuseScore_General soundfont (HQ or regular) supports single-note dynamics (SND), and you need at least version 0.1.6 of those soundfonts (from unstable or backports) for SND support!

    The command sudo update-alternatives --config MuseScore_General.sf3 can be used at any time to select the default soundfont used by MuseScore if you install more than one (note timgm6mb-soundfont cannot be selected here).

    Then, install the musescore3 package for MuseScore 3.x (the current stable version) or musescore for MuseScore 2.x (there’s also musescore-snapshot for the unstable developer preview). The packages are available in the following distributions:

    See https://backports.debian.org/Instructions/ for instructions on how to add an official Debian backports repository to your system and install packages from there.

    Note: without the appropriate backports, older versions may be available: MuseScore 2.0.3 on stretch, MuseScore 1.3 on jessie. Using the latest 2.3.2 version for 2.x-format scores instead (or conversion to 3.x) is strongly recommended!

    Fedora

    1. Import the GPG key:

      su
rpm --import http://prereleases.musescore.org/linux/Fedora/RPM-GPG-KEY-Seve
 

    2. Go to the download page of the MuseScore website. Click on the link for the stable Fedora download and choose the correct rpm package for your architecture.

    3. Depending on your architecture, use one of the two sets of commands to install MuseScore

      • for arch i386

        su
yum localinstall musescore-X.Y-1.fc10.i386.rpm
 

      • for arch x86_64

        su
yum localinstall musescore-X.Y-1.fc10.x86_64.rpm
 

    If you have difficulty with sound, see Fedora 11 and sound.
    See also the hints for the various distributions on the download page.

    KDE neon 18.04 (bionic)

    The KDE neon packages are built on a different repository than the normal Ubuntu PPAs, as this is the only way for us to build packages for KDE neon. Due to limitations of the OpenSuSE Buildservice used, this currently only provides amd64 (64-bit PC) packages, no ARM packages (Slimbook or Pinebook remix).

    All commands listed below must be entered in a terminal, in one line each.

    1. Remove the Ubuntu PPAs (all three of them) from your system if you’ve ever configured it before. This is generally in /etc/apt/sources.list or one of the files below /etc/apt/sources.list.d/; if you used add-apt-repository (the recommended way) to enable the PPA, you can remove them with: sudo rm -f /etc/apt/sources.list.d/mscore-ubuntu-ubuntu-mscore*

      KDE neon is not compatible with the Ubuntu PPAs!

    2. Install a few standard packages (usually they are already there, but just in case they aren’t) to be able to securely download the repository signature key:

      sudo apt-get install wget ca-certificates
 
    1. Download (via secure HTTPS connection) and install the repository signing key:
      wget -O - https://download.opensuse.org/repositories/home:/mirabile:/mscore/bionic-neon/Release.key | sudo apt-key add -
 
    1. Enable the repository:
      echo deb https://download.opensuse.org/repositories/home:/mirabile:/mscore/bionic-neon ./ | sudo tee /etc/apt/sources.list.d/mscore.list
 
    1. Make the new packages available:
      sudo apt-get update
 

    Now, it’s time to install one or more soundfont packages (ideally install the one you want before installing MuseScore):

    If you skip this step, a suitable soundfont will be automatically installed when you install MuseScore itself in the final step.

    Note: only the MuseScore_General soundfont (HQ or regular) supports single-note dynamics (SND), and you need at least version 0.1.6 of those soundfonts (from our repository) for SND support!

    The command sudo update-alternatives --config MuseScore_General.sf3 can be used at any time to select the default soundfont used by MuseScore if you install more than one (note timgm6mb-soundfont cannot be selected here).

    Finally, you can install the latest stable version of MuseScore with sudo apt-get install musescore3 and the old 2.x version with sudo apt-get install musescore (the musescore-snapshot package with an instable developer preview is also available).

    Ubuntu, Kubuntu, Xubuntu, …

    WARNING: these instructions are not for KDE neon users (see above)!

    MuseScore 2.x (the old version) is available from 18.10 (cosmic) to 19.10 (eoan) out of the box. Older Ubuntu releases carry older versions (18.04 (bionic) has 2.1, 16.04 (xenial) has 2.0, 14.04 (trusty) and 12.04 (precise) have 1.3 and 1.2, respectively). Similar to the Debian instructions, we recommend using the latest 2.3.2 version for old 2.x scores instead, or migrating those scores to MuseScore 3.

    Besides the versions supplied by the distribution itself, the MuseScore Debian packager provides newer versions of MuseScore for older Ubuntu releases in official PPAs (package archives).

    Please activate the Stable releases of MuseScore 3 repository on your system and then install the musescore3 package, available for all releases from 18.04 (bionic) onwards. (It is not feasible to provide MuseScore 3 for older Ubuntu releases, as those lack the minimum Qt version required by MuseScore 3.)

    If you wish to install the older MuseScore 2, activate the Stable releases of MuseScore 2 PPA and install the musescore package, available for 12.04 (precise), 14.04 (trusty), 16.04 (xenial), and 18.04 (bionic) onwards. (Some intermediate releases may have slightly older MuseScore versions still available, but it’s best to update to the next LTS.) On the ancient 12.04 (precise) and 14.04 (trusty) releases, this will upgrade the Qt library in your system, which may break unrelated software (and on 12.04 even the C++ libraries are upgraded), mind you; best to upgrade to a newer LTS.

    There’s also a MuseScore Nightly Builds (unstable development builds) PPA, from which the daring can install the musescore-snapshot package, for LTS, that is, 18.04 (bionic) only.

    WARNING: these PPAs are only suitable for Ubuntu/Kubuntu/Xubuntu/… but not for Debian or KDE neon!

    As with Debian, you can install one or more soundfont packages (ideally install the one you want before installing MuseScore, but if you don’t, a suitable one will be installed alongside MuseScore):

    Note: only the MuseScore_General soundfont (HQ or regular) supports single-note dynamics (SND), and you need at least version 0.1.6 of those soundfonts (possibly from the PPA) for SND support!

    The command sudo update-alternatives --config MuseScore_General.sf3 can be used at any time to select the default soundfont used by MuseScore if you install more than one (note timgm6mb-soundfont cannot be selected here).