2022-05-06 14:55:28 +02:00
# ![MuseScore](share/icons/musescore_logo_full.png)
2019-10-15 18:02:38 +02:00
Music notation and composition software
2017-10-20 02:29:39 +02:00
2021-04-15 16:16:23 +02:00
[![License: GPL v3 ](https://img.shields.io/badge/License-GPL%20v3-blue.svg )](https://www.gnu.org/licenses/gpl-3.0.en.html)
2013-09-30 10:14:15 +02:00
2018-02-17 18:57:49 +01:00
MuseScore is an open source and free music notation software. For support, contribution, and bug reports visit MuseScore.org. Fork and make pull requests!
2016-09-29 10:08:30 +02:00
2013-09-30 10:14:15 +02:00
## Features
2019-12-19 16:03:34 +01:00
- 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
2013-09-30 10:14:15 +02:00
## More info
2019-12-19 16:03:34 +01:00
- [MuseScore Homepage ](https://musescore.org )
- [MuseScore Git workflow instructions ](https://musescore.org/en/developers-handbook/git-workflow )
2023-03-16 07:39:08 +01:00
- [How to compile MuseScore? ](https://github.com/musescore/MuseScore/wiki/Set-up-developer-environment )
2012-05-28 11:04:58 +02:00
2013-09-30 10:14:15 +02:00
## License
2023-11-15 09:41:57 +01:00
MuseScore is licensed under GPL version 3.0. See [license file ](https://github.com/musescore/MuseScore/blob/master/LICENSE.txt ) in the same directory.
2013-09-30 10:14:15 +02:00
## Packages
2021-01-26 15:46:06 +01:00
See [Code Structure on Wiki ](https://github.com/musescore/MuseScore/wiki/CodeStructure )
2020-10-29 15:38:14 +01:00
2013-09-30 10:14:15 +02:00
2016-03-19 15:00:28 +01:00
## Building
2023-03-16 07:39:08 +01:00
**Read the [Compilation section ](https://github.com/musescore/MuseScore/wiki/Set-up-developer-environment ) of the [MuseScore Wiki ](https://github.com/musescore/MuseScore/wiki ) for a complete build walkthrough and a list of dependencies.**
2013-09-30 10:14:15 +02:00
2016-03-19 15:00:28 +01:00
### Getting sources
If using git to download repo of entire code history, type:
2013-12-31 10:52:04 +01:00
2016-03-19 15:00:28 +01:00
git clone https://github.com/musescore/MuseScore.git
cd MuseScore
2013-09-30 10:14:15 +02:00
2019-12-19 16:03:34 +01:00
Otherwise, you can just download the latest source release tarball from the [Releases page ](https://github.com/musescore/MuseScore/releases ), and then from your download directory type:
2013-12-31 10:52:04 +01:00
2016-03-19 15:00:28 +01:00
tar xzf MuseScore-x.x.x.tar.gz
cd MuseScore-x.x.x
2013-09-30 10:14:15 +02:00
2016-03-19 15:00:28 +01:00
### Release Build
2021-02-28 23:23:39 +01:00
To compile MuseScore for release, type:
2013-09-30 10:14:15 +02:00
2021-02-28 23:23:39 +01:00
cmake -P build.cmake -DCMAKE_BUILD_TYPE=Release
2013-12-31 10:52:04 +01:00
2021-02-28 23:23:39 +01:00
If something goes wrong, append the word "clean" to the above command to delete the build subdirectory:
2013-09-30 10:14:15 +02:00
2021-02-28 23:23:39 +01:00
cmake -P build.cmake -DCMAKE_BUILD_TYPE=Release clean
2013-09-30 10:14:15 +02:00
2021-02-28 23:23:39 +01:00
Then try running the first command again.
2016-03-19 15:00:28 +01:00
2021-02-28 23:23:39 +01:00
### Running
To start MuseScore, type:
2016-03-19 15:00:28 +01:00
2021-02-28 23:23:39 +01:00
cmake -P build.cmake -DCMAKE_BUILD_TYPE=Release run
2013-09-30 10:14:15 +02:00
2021-02-28 23:23:39 +01:00
Or run the compiled executable directly.
2013-09-30 10:14:15 +02:00
2016-03-19 15:00:28 +01:00
### Debug Build
2021-02-28 23:23:39 +01:00
A debug version can be built and run by replacing `-DCMAKE_BUILD_TYPE=Release`
with `-DCMAKE_BUILD_TYPE=Debug` in the above commands.
2013-09-30 10:14:15 +02:00
2021-02-28 23:23:39 +01:00
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.
2013-09-30 10:14:15 +02:00
2016-03-19 15:00:28 +01:00
### Testing
2023-06-21 17:49:40 +02:00
See the [Unit tests section ](https://github.com/musescore/MuseScore/wiki/Unit-tests ) of the [MuseScore Wiki ](https://github.com/musescore/MuseScore/wiki ) for instructions on how to run the test suite.
2020-05-29 00:52:22 +02:00
### 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` .