> For the complete documentation index, see [llms.txt](https://handbook.musescore.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handbook.musescore.org/3/appendix/known-incompatibilities.md).

# Known incompatibilities

## Hardware incompatibilities

The following software is known to crash MuseScore on startup:

* Samson USB Microphone, driver name "Samson ASIO Driver", samsonasiodriver.dll. [More info](https://musescore.org/en/node/6849)
* Digidesign MME Refresh Service. [More info](https://musescore.org/en/node/44611#comment-202706)
* Windows XP SP3 + Realtek Azalia Audio Driver. [More info](https://musescore.org/en/node/9132#comment-48696)
* Wacom tablet. [More info](https://musescore.org/en/node/7600#comment-54064) and [QTBUG-6127](https://bugreports.qt.io/browse/QTBUG-6127)

## Software incompatibilities

* Maple virtual cable is [known to prevent MuseScore](https://musescore.org/en/node/1335) from closing properly.
* KDE (Linux) window settings can cause the whole window to move when dragging a note. [Changing the window settings of the operating system](https://musescore.org/en/node/8318#comment-27683) avoids the problem.
* Nitro PDF Creator may [prevent MuseScore 2 from starting](https://musescore.org/en/node/92116#comment-421261) on Windows 10, if being used as the default printer. Same for Amyumi/Quickbooks PDF Printer, see [here](https://musescore.org/en/node/188076#comment-718611) and also some cloud printing services, see [here](https://musescore.org/en/node/92116#comment-787561).
* Creative Sound Blaster Z Series ASIO driver may [prevent MuseScore 2 from starting](https://musescore.org/en/node/93481#comment-581721) on Windows 10.
* Untrusted Font Blocking policy [prevents MuseScore 2 from starting](https://musescore.org/en/node/99886) (except in debug mode, i.e. using the -d option) on Windows 10. (Solution in [the links provided here](https://musescore.org/en/node/99886#comment-846635))
* The SteelSeries Engine 3 Audio Visualizer will prevent MuseScore from starting up, or cause MuseScore to crash if the Audio Visualizer is started when MuseScore is already running.
* MacOS 10.5+ Accessibility setting "Hover Text" crashes MuseScore 3. [Workaround is to disable that setting](https://musescore.org/en/node/317323)

### AVG Internet Security hangs MuseScore

MuseScore requires access to your internet connection with AVG. MuseScore doesn't need an internet connection to function, but if AVG blocks it, MuseScore hangs.

If AVG prompts you, **Allow** MuseScore and check "Save my answer as a permanent rule and do not ask me next time."

If it doesn't prompt you anymore,

1. Open the AVG user interface (right-click on the AVG icon, close to your clock -> Open AVG User Interface)
2. Click on *Firewall*
3. Click *Advanced Settings*
4. Click *Applications*
5. Find MSCORE.EXE in the list and double-click it
6. Change *Application Action* to ***Allow for All***

### Font problem on macOS

MuseScore is known to display notes as square when some fonts are damaged on macOS.\
To troubleshoot this issue:

1. Go to Applications -> Font Book
2. Select a font and press <kbd>⌘</kbd>+<kbd>A</kbd> to select them all
3. Go to File -> Validate Fonts
4. If any font is reported as damaged or with minor problems, select it and delete it
5. Restart MuseScore if necessary

In [this forum article](https://musescore.org/en/node/13772#comment-53876), a user believes to have found the font "Adobe Jenson Pro (ajenson)" to be the culprit, regardless of not being reported as broken, or problematic as per the above validation, and solved the problem by deleting that font, so this is worth checking too.

### Font problem on Linux

If the default desktop environment application font is set to bold, MuseScore will not display the notes properly.\
To troubleshoot this issue (gnome 2.\*/MATE users):

1. Right-click on your desktop and select Change Desktop background
2. Click on Fonts tab
3. Set Regular style for Application font
4. Restart MuseScore if necessary

For GNOME 3/SHELL users

1. Open the shell and open "Advanced Settings"
2. Click on the Fonts option in the list
3. Set the default font to something non-bold
4. Restart MuseScore if necessary

### Save As dialog empty on Linux

Some users reported that the Save As dialog is empty on Debian 6.0 and Lubuntu 10.10.\
To troubleshoot this issue:

1. Type the following in a terminal

   ```
   which mscore
   ```
2. The command will answer with the path of mscore. Edit it with your preferred text editor and add the following line at the beginning

   ```
   export QT_NO_GLIB=1
   ```

Launch MuseScore and the problem should be solved.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://handbook.musescore.org/3/appendix/known-incompatibilities.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
