121 lines
4 KiB
Markdown
121 lines
4 KiB
Markdown
# 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
|
|
* [MuseScore Homepage](http://musescore.org)
|
|
* [MuseScore Git workflow instructions](http://musescore.org/en/developers-handbook/git-workflow).
|
|
* [How to compile MuseScore?](http://musescore.org/en/developers-handbook/compilation)
|
|
* Build status: [](http://travis-ci.org/musescore/MuseScore)
|
|
|
|
## License
|
|
MuseScore is licensed under GPL version 2.0. See LICENSE.GPL in the same directory.
|
|
|
|
## Packages
|
|
* **aeolus** Clone of [Aeolus](http://kokkinizita.linuxaudio.org/linuxaudio/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.
|
|
|
|
* **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](http://sourceforge.net/apps/trac/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.
|
|
|
|
* **thirdparty/rtf2html**
|
|
Used for capella import
|
|
|
|
* **thirdparty/diff**
|
|
Not used currently. [Diff, Match and Patch Library](http://code.google.com/p/google-diff-match-patch/)
|
|
|
|
* **thirdparty/ofqf**
|
|
OSC server interface. Based on [OSC for Qt4](http://www.arnoldarts.de/ofqf.html)
|
|
|
|
* **thirdparty/singleapp**
|
|
Clone from [Qt Single Application](http://qt.gitorious.org/qt-solutions/qt-solutions/trees/master/qtsingleapplication)
|
|
|
|
* **thirdparty/portmidi**
|
|
Clone from [PortMidi](http://portmedia.sourceforge.net/)
|
|
|
|
* **thirdparty/beatroot**
|
|
It's a core part of BeatRoot Vamp Plugin by Simon Dixon and Chris Cannam,
|
|
used in MIDI import for beat detection. (http://code.soundsoftware.ac.uk/projects/beatroot-vamp/repository)
|
|
|
|
|
|
## Installation
|
|
**Read the developer handbook for a [complete build walkthrough](http://musescore.org/en/developers-handbook/compilation) and a list of dependencies.**
|
|
|
|
* unpack source distribution
|
|
|
|
tar xvofj mscore-x.x.x.tar.bz2
|
|
|
|
* make
|
|
|
|
cd mscore-x.x.x
|
|
make release
|
|
|
|
if something goes wrong, then remove the whole build subdirectory with `make clean` and start new with `make release`
|
|
|
|
* install as root user
|
|
|
|
sudo make install
|
|
|
|
### Program Documentation
|
|
To generate the program documentation with DoxyGen, type
|
|
|
|
cd build
|
|
make doxy
|
|
|
|
Browse the documentation with your favourite html browser at build/Doc/html/index.html
|
|
|
|
### Run
|
|
|
|
cd build.release/mscore
|
|
./mscore
|
|
|
|
to start MuseScore. On first invocation a demofile is shown. You probably want to change that in the "Preferences" dialog.
|
|
|
|
### Debug
|
|
A debug version can be built by doing `make debug` above, instead of `make release`.
|
|
|
|
To test the debug version, type
|
|
|
|
cd build.debug/mscore
|
|
./mscore
|