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 C CartoCSS HTML Other
Latest commit 0d26707 Dec 9, 2016 @lasconic lasconic committed on GitHub Merge pull request #2904 from shoogle/fixed-appimagekit-version
32-bit Docker image, and fixes for 64-bit
Permalink
Failed to load latest commit information.
.tx add ability to translate instruments.xml Aug 7, 2014
aeolus more cmake cleanups Jan 27, 2015
assets improving Linux packaging (node:60131) Jun 25, 2015
audiofile fix #114681: add loop support to zerberus Jun 22, 2016
awl Fix spelling in CMakeLists.txt files Jun 10, 2016
build 32-bit Docker image, and fixes for 64-bit Dec 9, 2016
bww2mxml fix some compiler warnings on Mac Jan 28, 2015
demos remove post 1.3 and pre-2.0 compatibility checks and tweaks May 13, 2016
effects slur cleanups Jul 4, 2016
fluid fix #120061: fix clicking sound in playback due to filter init Aug 3, 2016
fonts Merge pull request #2875 from lasconic/MuseJazzText Nov 14, 2016
fonttools Updates to tremolo bar support, merge fixes Aug 15, 2014
libmscore fix incremental layout of slurs Dec 9, 2016
manual Simplify texts in various dialogs, for translators' benefit Mar 25, 2016
midi fix #122626: Fail to import MIDI file properly Aug 27, 2016
miditools whitespace cleanup May 30, 2014
mscore fix incremental layout of slurs Dec 9, 2016
mstyle fix compiler warnings reg. overloaded virtual functions in mstyle Dec 3, 2016
mtest fix incremental layout of slurs Dec 9, 2016
omr rename Xml() -> XmlWriter() Nov 19, 2016
rdoc remove file artifacts from rdoc folder Feb 9, 2015
share Add more noteheads and staff type for dynamic noteheads (shapes, note… Nov 18, 2016
synthesizer rename Xml() -> XmlWriter() Nov 19, 2016
test fix #11014 Ove import: import of chordnames is wrong Aug 1, 2016
thirdparty fix #117206: OSC command /Tempo processes the parameter value wrong Jul 7, 2016
vtest update MuseJazz and MuseJazzText Nov 4, 2016
zerberus add score ptr to XmlReader and Xml Nov 19, 2016
.gitignore update mtest Apr 13, 2016
.travis.yml comment linux 32 bit and ARM for travis-ci Sep 6, 2016
CMakeLists.txt fix precompiled header compilation with Qt 5.7 Sep 14, 2016
Compatibility enhanced 1.2 import Aug 23, 2012
LICENSE.GPL fix #86196: Licence text displayed in a hard to read font on Windows Nov 5, 2015
LICENSE.rtf fix #86196: Licence text displayed in a hard to read font on Windows Nov 5, 2015
Makefile bump up version to 3.0 Apr 21, 2016
Makefile.mingw bump up version to 3.0 Apr 21, 2016
Makefile.osx fix MacOSX makefile, allow failure on travis for macosx May 12, 2016
README.md add description in README.md Sep 29, 2016
admin add new sfz sample player: zerberus Mar 26, 2013
all.h implement #110796 Batch conversion from the command line; speedup vte… May 14, 2016
mscore3.txt implement dynamicsPosAbove/dynamicsPosBelow style values Nov 18, 2016

README.md

MuseScore: Music notation and composition software

MuseScore is an open source and free music notation software. For support, contribution, 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 http://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

  • mstyle Clone of KDE4 style Oxygen

  • 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

Else 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.