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
Dmitri Ovodok 9c2e6f759e
Merge pull request #5809 from Jojo-Schmitz/crash
fix #302304: prevent potential crash when adding instruments
2020-03-19 15:04:37 +02:00
.github Run vtests on PRs and commits to master branch and compare to parent commit vtest results; output a comment and upload a report when differences are found 2020-02-27 09:34:13 +01:00
.tx Make tours translatable 2018-12-21 23:23:17 +01:00
.vscode add debug configuration for VSCode 2020-02-08 10:06:15 +00:00
aeolus follow up pr #4535: display patches in mixer in order of preset number rather than bank 2019-01-25 21:16:08 +00:00
assets remove the Unix executable attribute from the new assets 2019-08-29 17:40:12 +02:00
audiofile eliminate debug artifacts 2018-12-18 14:55:54 +01:00
avsomr fix some (translatable) texts 2020-03-18 14:32:06 +01:00
awl fix various typos 2019-12-19 06:13:30 -05:00
build added audiveris import 2020-03-18 11:23:46 +02:00
bww2mxml remove RCS IDs from (almost) all files 2018-11-02 23:53:21 +01:00
crashreporter fix #284988: Remove "Restart MuseScore" option from crash reporter 2020-02-05 15:42:40 +02:00
demos update demo 2019-04-19 11:22:13 +01:00
doc Update and add 1.x plugin documentation pages to Doxygen-based docs 2019-12-25 11:10:25 +02:00
effects fix various typos 2019-12-19 06:13:30 -05:00
fluid fix some compiler warnings differently/cleaner 2020-03-03 14:39:24 +01:00
fonts Update Bravura and BravuraText to latest Steinberg version 1.32 2020-03-12 10:17:46 +01:00
fonttools eliminate debug artifacts 2018-12-18 14:55:54 +01:00
global added audiveris import 2020-03-18 11:23:46 +02:00
libmscore fix #302304: prevent potential crash when adding instruments 2020-03-19 12:46:38 +01:00
main added audiveris import 2020-03-18 11:23:46 +02:00
manual Remove the existing offline plugins documentation 2019-03-22 18:14:54 +02:00
midi This commit contains changes required for MuseScore to compile under MSVC with no warnings. 2018-08-03 09:15:42 +02:00
miditools Add single-note dynamics 2019-03-02 18:18:12 +00:00
mscore Merge pull request #5809 from Jojo-Schmitz/crash 2020-03-19 15:04:37 +02:00
mtest Merge pull request #5804 from mattmcclinch/302282-ignore-activeCR 2020-03-19 14:27:26 +02:00
omr fix compiler error in importpdf 2019-02-18 08:47:21 -05:00
rdoc remove file artifacts from rdoc folder 2015-02-09 11:02:14 +01:00
share Merge pull request #5764 from Jojo-Schmitz/baritone-horn 2020-03-10 13:45:05 +02:00
synthesizer Fix MinGW and MSVC compiler warnings 2019-11-22 15:44:50 +01:00
telemetry added audiveris import 2020-03-18 11:23:46 +02:00
test fix #11014 Ove import: import of chordnames is wrong 2016-08-01 18:35:41 +02:00
thirdparty fix MSVC compiler warnings for telemetry and google_analytics 2019-12-24 16:31:37 +01:00
vtest Merge pull request #5523 from MarcSabatella/298273-divider-spacer 2020-03-12 15:25:47 +02:00
zerberus Move main() function out of mscore directory 2019-12-04 11:11:14 +02:00
.appveyor.yml Add the changes that are not used in dev builds, but needed for releases 2019-11-11 10:21:52 +02:00
.gitignore Run vtests on PRs and commits to master branch and compare to parent commit vtest results; output a comment and upload a report when differences are found 2020-02-27 09:34:13 +01:00
.gitmodules Add libcrashreporter-qt 2019-02-25 12:08:14 +03:00
.travis.yml do shortest job first 2019-12-12 08:50:09 +01:00
all.cpp remove RCS IDs from (almost) all files 2018-11-02 23:53:21 +01:00
all.h added audiveris import 2020-03-18 11:23:46 +02:00
CMakeLists.txt added audiveris import 2020-03-18 11:23:46 +02:00
CMakeSettings.json Support 64-bit compilation 2018-08-23 10:48:56 +02:00
Compatibility enhanced 1.2 import 2012-08-23 12:28:27 +02:00
Doxyfile.plugins Update and add 1.x plugin documentation pages to Doxygen-based docs 2019-12-25 11:10:25 +02:00
LICENSE.GPL Update copyright 2020-01-15 00:13:54 +08:00
LICENSE.rtf Update copyright 2020-01-15 00:13:54 +08:00
Makefile Fix a typo in Makefile from 0b37675892 2020-03-12 14:41:31 +02:00
Makefile.mingw update master to 3.5 2020-02-07 11:59:29 +02:00
Makefile.osx update master to 3.5 2020-02-07 11:59:29 +02:00
mscore3.txt fix various typos 2019-12-19 06:13:30 -05:00
msvc_build.bat Added a track id build option for Win, OSX and Linux 2019-12-20 16:22:27 +02:00
README.md update and perfect format for README.md 2019-12-19 23:03:34 +08:00

MuseScore
Music notation and composition software

Travis CI Appveyor License: GPL v2

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 2.0. See LICENSE.GPL in the same directory.

Packages

  • aeolus: Clone of Aeolus. Disabled by default in the stable releases. See http://dev-list.musescore.org/Aeolus-Organ-Synth-td7578364.html. Kept as an example of how to integrate with a complex synthesizer.

  • assets: Graphical assets, use them if you need a MuseScore icon. For logo, color, etc., see https://musescore.org/en/about/logos-and-graphics.

  • awl: Audio Widget Library, from the MusE project.

  • build: Utility files for build.

  • bww2mxml: Command line tool to convert BWW files to MusicXML. BWW parser is used by MuseScore to import BWW files.

  • demos: A few MuseScore files to demonstrate what can be done.

  • fluid: Clone of FluidSynth@sourceforge, ported to C++ and customized. Code now at fluidsynth@github.

  • fonts: Contains fontforge source (sfd) + ttf/otf fonts. MuseScore includes the "Emmentaler" font from the Lilypond project.

  • libmscore: Data model of MuseScore.

  • mscore: Main code for the MuseScore UI.

  • msynth: Abstract interface to Fluid + Aeolus.

  • mtest: Unit testing using QTest.

  • omr: Optical music recognition.

  • share: Files moved to /usr/share/... on install.

  • test: Old tests. Should move to mtest.

  • vtest: Visual tests. Compare reference images with current implementation.

  • thirdparty: Contains projects which are included for convenience, usually to integrate them into the build system to make them available for all supported platforms.

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, type:

make release

If something goes wrong, then remove the whole build subdirectory with make clean and start new with make release.

Running

To start MuseScore, type:

./build.release/mscore/mscore

The Start Center window will appear on every invocation until you disable that setting via the "Preferences" dialog.

Installing

To install to default prefix using root user, type:

sudo make install

Debug Build

A debug version can be built by doing make debug instead of make release.

To run the debug version, type:

./build.debug/mscore/mscore

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!