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
Nicolas Froment a65f06be68 Merge pull request #2513 from shoogle/appimage-improvements
Improve AppImages including fix 104106 use system font settings
2016-04-01 15:12:47 +04:00
.tx add ability to translate instruments.xml 2014-08-07 10:28:13 +02:00
aeolus more cmake cleanups 2015-01-27 15:23:20 +01:00
assets improving Linux packaging (node:60131) 2015-06-25 13:30:15 +01:00
audiofile whitespace cleanup 2014-05-30 13:37:44 +02:00
awl add compressor effect 2015-09-08 15:39:30 +02:00
build Improve AppImages including fix #104106 use system font settings 2016-04-01 11:26:16 +01:00
bww2mxml fix some compiler warnings on Mac 2015-01-28 14:44:55 +01:00
demos add another demo file 2015-05-13 11:55:59 +02:00
effects fix zita process() loop 2016-03-29 13:42:06 +04:00
fluid fix #99236 remove mscoreGlobalShare/sound from soundfont path 2016-02-25 05:28:43 -05:00
fonts TAB: New historical English fret style 2015-11-25 10:39:13 +01:00
fonttools Updates to tremolo bar support, merge fixes 2014-08-15 16:22:34 +01:00
libmscore Merge pull request #2280 from MarcSabatella/84876-extend-select-last 2016-04-01 12:24:44 +04:00
manual update helpBrowser 2015-02-18 12:26:26 +01:00
midi Fix char sign to pass tests on ARM. 2016-03-30 13:07:30 -04:00
miditools whitespace cleanup 2014-05-30 13:37:44 +02:00
mscore fix #21950: crash in debugger when using Layout button 2016-03-30 21:08:04 +02:00
mstyle improve drawing of radiobutton on retina display 2016-02-01 11:32:08 +04:00
mtest fix #96631 Expose TextStyleTypes to QML + test case 2016-03-30 20:18:18 +02:00
omr more cmake cleanups 2015-01-27 15:23:20 +01:00
rdoc remove file artifacts from rdoc folder 2015-02-09 11:02:14 +01:00
share Merge pull request #2412 from jeetee/fix_cursor_addNote_cursor_position 2016-03-29 18:07:12 +04:00
synthesizer Revert "fix #86981: increase default volume" 2016-03-22 21:03:37 +04:00
test ove import fixes and tests 2015-05-15 15:39:11 +02:00
thirdparty fix some scaling regressions 2015-11-18 18:09:59 +01:00
vtest Merge pull request #2284 from MarcSabatella/84206-volta-courtesy 2016-03-14 14:32:26 +04:00
zerberus add README for zerberus 2016-03-10 12:00:08 +04:00
.gitignore use AUTOMOC in cmake files 2015-01-27 15:23:20 +01:00
.travis.yml cross compile AppImage in debian docker on travis for armhf 2016-03-29 22:14:49 -04:00
admin add new sfz sample player: zerberus 2013-03-26 20:00:19 +01:00
all.h fix compiling for qt5.5 2015-07-08 14:39:33 +02:00
CMakeLists.txt clean CMake output on Mac and Windows 2016-03-30 15:31:15 +04:00
Compatibility enhanced 1.2 import 2012-08-23 12:28:27 +02:00
LICENSE.GPL fix #86196: Licence text displayed in a hard to read font on Windows 2015-11-05 11:19:15 +01:00
LICENSE.rtf fix #86196: Licence text displayed in a hard to read font on Windows 2015-11-05 11:19:15 +01:00
Makefile cross compile AppImage in debian docker on travis for armhf 2016-03-29 22:14:49 -04:00
Makefile.mingw windows makefile set default number of jobs to %NUMBER_OF_PROCESSORS% 2015-08-09 06:09:17 -04:00
Makefile.osx go back to development mode 2015-03-24 23:11:13 +01:00
README.md Fixed Doxyfiles & README.md, so make doxy builds. 2016-03-19 10:00:36 -04:00

MuseScore: Music notation and composition software

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.

Program Documentation

To generate program documentation using DoxyGen, first do make debug, then type:

make doxy

Browse the documentation in subdirectory Doc/html/index.html using any html browser.