musescore / musescore/MuseScore
Qt installation instructions out of date
@shoogle is already working on this.
Since Jul 10, 2026.
- 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:
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.