musescore / musescore/MuseScore

Qt installation instructions out of date

Open
#34,137 4 comments 0 reactions 1 assignee View on GitHub

@shoogle is already working on this.

Since Jul 10, 2026.

dev
Dominant language
C++
Stars
15.1k
Forks
3.3k
Avg merge
2d 2h
Merged PRs (30d)
91

Description

Issue type

Other type of issue

Description with steps to reproduce

(Apologies if this is not the right way to report this kind of issue - please let me know.)

I've been attempting to follow the developer setup instructions on macOS, with no prior knowledge of MuseScore code, or Qt.

This page looks like it needs to be updated as it doesn't quite match the Qt installer's current design and questions. I'm not confident enough to make these changes myself.

Some specifics:

You probably don't want to associate common file types with Qt Creator.

I didn't see any options about this.

We don't use Qt Design Studio, so you don't need that or anything else Qt offers you on this screen.

This is confusing because the default option is just "Developer tools Qt 6.11 for desktop development", which I'm guessing is what we do want. (Well...I'm not sure. Maybe it's best that the user deselects all the main options, and just picks the individual components? Either way, it is unclear.)

Different versions of MuseScore Studio require different versions of Qt

This whole section was pretty confusing, and could do with some general recommendations, like "If you plan to just work on the latest stable release, do the following".

It's not clear whether installing a Qt that's too new (eg, 6.10.3 instead of 6.10.2) is bad. I wasn't sure whether the mismatch here was because the wiki instructions are just out of date, or whether you really do need to not use a newer version.

It's not clear whether installing more than one version of Qt is good or bad.

At the right hand side, under Categories, select Archive and click Filter.

There's no "Categories", the drop-down is showing "Show". There's "Archive", but no Filter. This section of instructions doesn't seem to match the current installer UI.

In the tree view, expand the component group named Qt.

There's no top level component group named Qt. There's "Qt for development" which has "Qt" inside it.

The "Name of prebuilt component in the tree view" doesn't seem to be "macOS". It seems to be "Desktop" (details: Qt 6.10.2 Prebuilt Components for macOS (Universal, x86_64/arm64) )

At the bottom of the tree view, expand Qt Creator.

Qt Creator appears to be at the top, under Developer Tools, and it's called "Qt Creator 2.0.0".

It might be helpful to include an indicative screenshot of the components you should end up with, like:

Image

Also, there are lots of instructions to not install things, but no explanation: is it simply about disk space, or might problems arise from installing the wrong things? (At one point I accidentally had iOS selected, which would have chewed up another 11GB...)

Supporting files, videos and screenshots

n/a

In which versions of MuseScore Studio is this issue present?

n/a

Regression

I was unable to check

Operating system

n/a

Additional context

No response

Checklist
  • This report follows the guidelines for reporting bugs and issues
  • I have verified that this issue has not been logged before, by searching the issue tracker for similar issues
  • I have attached all requested files and information to this report
  • I have attempted to identify the root problem as concisely as possible, and have used minimal reproducible examples where possible

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.