MuseScore/README.md
2015-03-21 10:21:22 +01:00

4.2 KiB

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.

Installation

Read the developer handbook for a complete build walkthrough 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