Revert to factory settings

Recent versions of MuseScore have the option to revert back to the standard built-in presets or "factory-settings". This can be necessary if your settings are corrupted. Warning: Reverting to factory settings removes any changes you have made to the preferences, palettes, or window settings. This is not a commonly needed procedure; consult the forums first, as there may be a way to solve your problem without resetting everything.

MuseScore 2.0.3 and above

In recent versions it is possible to revert from within MuseScore, providing that MuseScore itself is able to start.
Go to HelpRevert to Factory Settings. A warning dialog will appear:

Revert to factory settings

Clicking Yes resets all MuseScore's settings as if the program was installed for the first time, and MuseScore will immediately restart. No will safely cancel the revert.

MuseScore 2.0 through 2.0.2

In older versions of MuseScore, or in later versions if they do not start, you must run this process via the command line.

Instructions for Windows

  1. If you have MuseScore open, you need to close it first (FileQuit)
  2. Type Windows key+R to open the Run dialog (The Windows key is the one with the logo for Microsoft Windows). Alternatively select Start using your mouse.
  3. Click Browse...
  4. Look for MuseScore.exe on your computer. The location may vary depending on your installation, but it is probably something similar to My Computer → Local Disk → Program Files (or Program Files (x86)) → MuseScore 2 → bin → MuseScore.exe
  5. Click Open to leave the Browse dialog and return to the Run dialog. The following text (or something similar) should display in the Run dialog

    "C:\Program Files\MuseScore 2\bin\MuseScore.exe"
    

    For 64-bit Windows, the location is

    "C:\Program Files (x86)\MuseScore 2\bin\MuseScore.exe"
    
  6. Click after the quote and add a space followed by a hyphen and a capital F: -F

  7. Press OK

After a few seconds, MuseScore should start and all the settings reverted to "factory settings".

For advanced users, the main preference file is located at:

  • Windows Vista or later: C:\Users\<USERNAME>\AppData\Roaming\MuseScore\MuseScore2.ini
  • Windows XP or earlier: C:\Documents and Settings\USERNAME\Application Data\MuseScore\MuseScore2.ini

The other preferences (palette, session...) are in:

  • Windows Vista or later: C:\Users\<USERNAME>\AppData\Local\MuseScore\MuseScore2\
  • Windows XP or earlier: C:\Documents and Settings\USERNAME\Local Settings\Application Data\MuseScore\MuseScore2\

Instructions for MacOS

  1. If you have MuseScore open, you need to quit the application first (MuseScoreQuit)
  2. Open Terminal (in Applications/Utilities, or via Spotlight search) and a session window should appear
  3. Type (or copy/paste) the following command into your terminal line (include the '/' at the front):

    /Applications/MuseScore\ 2.app/Contents/MacOS/mscore -F
    

This resets all MuseScore preferences to factory settings and immediately launches the MuseScore application. Note that you cannot quit the Terminal without quitting MuseScore. You can safely quit MuseScore, quit the Terminal, and then reopen MuseScore in the normal fashion, ready to continue using.

For advanced users, the main MuseScore preference file is located at ~/Library/Preferences/org.musescore.MuseScore2.plist.

The other preferences (palette, session...) are in ~/Library/Application\ Support/MuseScore/MuseScore2/

Instructions for Linux

The following is true for Ubuntu, and most likely all other Linux distributions and UNIX-style operating systems.

  1. If you have MuseScore open, you need to quit the application first (FileQuit)
  2. From the Ubuntu main menu, choose ApplicationsAccessoriesTerminal. A Terminal session window should appear
  3. Type, (or copy/paste) the following command into your terminal line (Ctrl+Shift+V to paste in Terminal):

    mscore -F
    

    Or, if you are using the AppImage version, you must first use the cd command to change directory to wherever you saved the AppImage. For example, if you saved it to your Desktop:

    cd ~/Desktop
    ./MuseScore*.AppImage -F
    

This resets all MuseScore preferences to factory settings and immediately launches the MuseScore application. You can now quit Terminal, and continue using MuseScore.

For advanced users, the main MuseScore preference file is located at ~/.config/MuseScore/MuseScore2.ini. The other preferences (palette, session...) are in ~/.local/share/data/MuseScore/MuseScore2/

See also

Do you have an unanswered question? Post it in the forum.