MuseScore is an open source and free music notation software. For support, contribution, bug reports, visit MuseScore.org. Fork and make pull requests!
Find a file
2021-06-07 12:14:02 +02:00
.github Added an issue template for development tasks 2021-05-20 12:15:43 +02:00
.tx
.vscode
assets
build Merge pull request #8265 from igorkorsukov/mu4/ci/windows_qt_update_0607 2021-06-07 12:14:02 +02:00
demos
doc
fonts Implemented standard dialogs 2021-05-26 10:31:40 +02:00
hooks
mtest
rdoc
sandbox/cpad
share Update instrument id of strings to make sure automatic bracketing is working correctly when these templates are used. 2021-06-04 01:55:47 +02:00
src Merge pull request #8247 from igorkorsukov/mu4/engraving/geometry 2021-06-07 09:36:23 +02:00
test
thirdparty fixed dragging panels 2021-05-28 12:30:43 +02:00
tools fixed path in the smufl2sym.sh 2021-06-04 12:45:12 +03:00
vtest
.git-blame-ignore-revs Update .git-blame-ignore-revs 2021-04-19 22:29:45 +02:00
.gitattributes
.gitignore
build.cmake
CMakeLists.txt added USE_SCORE_ACCESSIBLE_TREE cmake option 2021-06-01 11:54:41 +03:00
CMakeSettings.json
Compatibility
config.cmake
CONTRIBUTING.md fix #124416: Add Contributing.md 2021-05-13 16:18:43 +01:00
Doxyfile.plugins
LICENSE.GPL
Makefile
Makefile.mingw
Makefile.osx
mscore3.txt
msvc_build.bat
ninja_build.bat
ninja_build.sh fixed run utests on CI 2021-05-27 14:32:04 +03:00
README.md

MuseScore Music notation and composition software

License: GPL v3

MuseScore is an open source and free music notation software. For support, contribution, and bug reports visit MuseScore.org. Fork and make pull requests!

Features

  • WYSIWYG design, notes are entered on a "virtual notepaper"
  • TrueType font(s) for printing & display allows for high quality scaling to all sizes
  • Easy & fast note entry
  • Many editing functions
  • MusicXML import/export
  • MIDI (SMF) import/export
  • MuseData import
  • MIDI input for note entry
  • Integrated sequencer and software synthesizer to play the score
  • Print or create pdf files

More info

License

MuseScore is licensed under GPL version 3.0. See LICENSE.GPL in the same directory.

Packages

See Code Structure on Wiki

Building

Read the developer handbook for a complete build walkthrough and a list of dependencies.

Getting sources

If using git to download repo of entire code history, type:

git clone https://github.com/musescore/MuseScore.git
cd MuseScore

Otherwise, you can just download the latest source release tarball from the Releases page, and then from your download directory type:

tar xzf MuseScore-x.x.x.tar.gz
cd MuseScore-x.x.x

Release Build

To compile MuseScore for release, type:

cmake -P build.cmake -DCMAKE_BUILD_TYPE=Release

If something goes wrong, append the word "clean" to the above command to delete the build subdirectory:

cmake -P build.cmake -DCMAKE_BUILD_TYPE=Release clean

Then try running the first command again.

Running

To start MuseScore, type:

cmake -P build.cmake -DCMAKE_BUILD_TYPE=Release run

Or run the compiled executable directly.

Debug Build

A debug version can be built and run by replacing -DCMAKE_BUILD_TYPE=Release with -DCMAKE_BUILD_TYPE=Debug in the above commands.

If you omit the -DCMAKE_BUILD_TYPE option entirely then RelWithDebInfo is used by default, as it provides a useful compromise between Release and Debug.

Testing

See mtest/README.md or the developer handbook for instructions on how to run the test suite.

The new script testing facility is also available to create your own automated tests. Please try it out!

Code Formatting

Run ./hooks/install.sh to install a pre-commit hook that will format your staged files. Requires that you install uncrustify.

If you have problems, please report them. To uninstall, run ./hooks/uninstall.sh.