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
2020-05-20 14:14:55 +02:00
.github add missing ccache package for CI compilation 2020-04-01 19:31:06 +02: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 Update aeolus to the latest Synthesizer interface. 2020-01-15 16:48:13 -07:00
assets remove the Unix executable attribute from the new assets 2019-08-29 17:40:12 +02:00
audio Moved midi, synthesizers, drives, exports to audio module 2020-04-16 12:23:51 +02:00
audiofile Moved midi, synthesizers, drives, exports to audio module 2020-04-16 12:23:51 +02:00
avsomr fix typos 2020-04-08 14:32:44 +02:00
awl color label, setColor emits colorChanged 2020-04-29 00:06:57 +03:00
build Merge pull request #6066 from Jojo-Schmitz/man-page 2020-05-20 14:14:37 +02:00
bww2mxml moved all imports/exports to importexport module 2020-04-10 11:30:48 +02: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 fixed some issues from PVS-Studio report (step1) 2020-03-20 12:18:07 +02:00
fonts regenerate “our” fonts with genttf 2020-04-15 16:17:45 +02:00
fonttools fix #43906: completing support of 256th, 512th and 1024th durations 2020-04-19 13:13:04 +02:00
global Merge pull request #5808 from blackears/278988-paste-non-contigious-notes-in-PRE-2 2020-05-03 01:46:53 +03:00
importexport fix #299393: [Musicxml Export] - Shortcut hairpin dynamic not exported 2020-05-03 11:03:15 +02:00
libmscore Merge pull request #6073 from IsaacWeiss/305265-bracket-span 2020-05-20 14:14:03 +02:00
main Remove manual (helpbrowser) from the plugin creator. 2020-04-10 02:11:24 -04:00
miditools Add single-note dynamics 2019-03-02 18:18:12 +00:00
mscore Merge pull request #6063 from Jojo-Schmitz/shortcut-text 2020-05-20 14:14:48 +02:00
mtest Merge pull request #6025 from lvinken/299393-shortcut-hairpin-dynamic 2020-05-18 10:30:48 -07: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 #6061 from Jojo-Schmitz/Cimbalom 2020-05-20 14:14:55 +02:00
telemetry Disable sending all events to telemetry, but the ones responsible for Crash Free ratio 2020-04-24 17:36:44 +02:00
test fix #11014 Ove import: import of chordnames is wrong 2016-08-01 18:35:41 +02:00
thirdparty Fix #304725: Remove “using namespace std” directive 2020-04-30 17:45:10 -07:00
vtest update vtest ref file generation script 2020-04-29 16:19:42 +01:00
.appveyor.yml Switch to Microsoft Visual Studio 2019 2020-04-14 21:55:16 +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 Merge pull request #5628 from Marr11317/plugindoc 2020-04-21 15:59:56 +03:00
CMakeSettings.json Switch to Microsoft Visual Studio 2019 2020-04-14 21:55:16 +02:00
Compatibility enhanced 1.2 import 2012-08-23 12:28:27 +02:00
config.cmake switch master branch to MuseScore 4 2020-05-04 11:47:44 +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 Change Linux Makefile to match the Windows and Mac ones 2020-04-20 12:11:59 +02:00
Makefile.mingw Change Linux Makefile to match the Windows and Mac ones 2020-04-20 12:11:59 +02:00
Makefile.osx Change Linux Makefile to match the Windows and Mac ones 2020-04-20 12:11:59 +02:00
mscore3.txt fix various typos 2019-12-19 06:13:30 -05:00
msvc_build.bat Fix #303864: Support command-line building using Visual Studio 2019 2020-04-14 09:54:23 -07: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!