MuseScore is an open source and free music notation software. For support, contribution, bug reports, visit MuseScore.org. Fork and make pull requests!
C++ CMake Shell Objective-C CartoCSS HTML Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.tx add ability to translate instruments.xml Aug 7, 2014
aeolus This commit contains all the changes to the CMake build system requir… Aug 3, 2018
assets improving Linux packaging (node:60131) Jun 25, 2015
audiofile This commit contains all the changes to the CMake build system requir… Aug 3, 2018
awl fix #274894 Crash if changing 'vertical frame bottom margin' leads to… Aug 6, 2018
build Change_loader_path to executable_path for non Qt dylib Aug 14, 2018
bww2mxml This commit contains changes required for MuseScore to compile under … Aug 3, 2018
demos remove post 1.3 and pre-2.0 compatibility checks and tweaks May 13, 2016
effects This commit contains changes required for MuseScore to compile under … Aug 3, 2018
fluid Compile under MSVC: this commit caontais all changes to run MSVC build Aug 4, 2018
fonts Merge pull request #3507 from mgavioli/Licenses_for_Tab_and_FigBass_f… Mar 5, 2018
fonttools This commit contains all the changes to the CMake build system requir… Aug 3, 2018
libmscore Fix #275356: tremolo bar displays incorrectly Aug 18, 2018
manual Compile under MSVC: this commit caontais all changes to run MSVC build Aug 4, 2018
midi This commit contains changes required for MuseScore to compile under … Aug 3, 2018
miditools This commit contains all the changes to the CMake build system requir… Aug 3, 2018
mscore Merge pull request #3840 from MarcSabatella/274841-rewind-home Aug 20, 2018
mtest fix delete of LetRing and PalmMute; updates for Trill and Hairpin in … Aug 6, 2018
omr This commit contains changes required for MuseScore to compile under … Aug 3, 2018
rdoc remove file artifacts from rdoc folder Feb 9, 2015
share fix concert pitch clef issues Jul 23, 2018
synthesizer This commit contains changes required for MuseScore to compile under … Aug 3, 2018
test fix #11014 Ove import: import of chordnames is wrong Aug 1, 2016
thirdparty Disable all current MSVC warnings for thirdparty/poppler Aug 8, 2018
vtest fixed vtest on Windows Aug 18, 2018
zerberus This commit contains changes required for MuseScore to compile under … Aug 3, 2018
.appveyor.yml remove artifact on appveyor so build is green. Aug 8, 2018
.gitignore tell git to ignore msvc.build.relwithdebinfo Aug 8, 2018
.travis.yml [Travis-CI] Zip and upload source code, soundfont, revision.h for sta… Mar 19, 2018
CMakeLists.txt Merge pull request #3858 from Jojo-Schmitz/MSVC-warnings Aug 14, 2018
CMakeSettings.json Compile under MSVC: this commit caontais all changes to run MSVC build Aug 4, 2018
Compatibility enhanced 1.2 import Aug 23, 2012
LICENSE.GPL fix #186571: update copyright in license shown by installer Apr 8, 2017
LICENSE.rtf fix #186571: update copyright in license shown by installer Apr 8, 2017
Makefile fix #267644: Add auto updater to MuseScore development versions Jul 19, 2018
Makefile.mingw fix #267644: Add auto updater to MuseScore development versions Jul 19, 2018
Makefile.osx fix #267644: Add auto updater to MuseScore development versions Jul 19, 2018
README.md A Few README Tweaks Feb 17, 2018
all.cpp This commit contains all the changes to the CMake build system requir… Aug 3, 2018
all.h Compile under MSVC: this commit caontais all changes to run MSVC build Aug 4, 2018
mscore3.txt fix #264594 lyrics update Jul 19, 2018
msvc_build.bat Fix disappeared "Check for updates menu item" Aug 8, 2018

README.md

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, ported to C++ and customized

  • 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 https://github.com/musescore/MuseScore/releases, 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 https://musescore.org/en/developers-handbook/testing for instructions on how to run the test suite.