
Rosegarden v15.12 and Later
===========================

Rosegarden is a MIDI and audio sequencer and musical notation editor for Linux.

  http://www.rosegardenmusic.com/

Please keep an eye on the FAQ for known problems and workarounds:

  http://rosegardenmusic.com/wiki/frequently_asked_questions

When you find bugs, first check whether a newer version of Rosegarden
has been released yet; if not, please continue on to:

  http://rosegardenmusic.com/tutorials/bug-guidelines.html

Release notes are available on the wiki:

  http://www.rosegardenmusic.com/wiki/start


Build requirements
------------------

For a complete list of build requirements, please see:

http://www.rosegardenmusic.com/wiki/dev:contributing


Installation instructions
-------------------------

In the directory where you found this README file, create a build directory
and compile the code there. Here are the commands to do so:

    mkdir build
    cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=[PREFIX] [-DCMAKE_BUILD_TYPE=Debug]
    make
    make install

You can also simply open the CMakeLists.txt file in an IDE (such as QtCreator,
KDevelop or Eclipse) and trigger the build from there.

New starting with 10.02, most of the application data files are bundled in the
rosegarden binary.  The install process will only copy a few files to various
directories under [PREFIX]:

    [PREFIX]/bin                                   application binary
    [PREFIX]/share/icons/hicolor/.../mimetypes     MIME type icons
    [PREFIX]/share/mime/packages                   MIME type configuration
    [PREFIX]/share/applications                    .desktop file
    [PREFIX]/share/icons/hicolor/32x32/apps        application icon

The optional [-DCMAKE_BUILD_TYPE=Debug] will build Rosegarden so that it is
useful for debugging, which can greatly improve our ability to find and
correct bugs by allowing Rosegarden to produce useful stack traces when it
crashes.  WARNING!  Enabling this option results in an approximately 300 MB
rosegarden binary!  It also results in the use of shared libs, and the
building of unit tests.  If you want to disable this (to go back to a static
lib and no unit tests), pass -DBUILD_TESTING=OFF to cmake.

You can force a specific Qt version using either -DUSE_QT4=1 or -DUSE_QT5=1.

Support for LIRC (Linux Infrared Remote Control) can be disabled using
-DDISABLE_LIRC=1.


Runtime requirements
--------------------

In order to be fully functional and provide the optimal user experience,
Rosegarden requires the following external applications.

  - General MIDI soft synth (TiMidity + Freepats or better)
  - LilyPond
  - Okular, Evince, Acroread, MuPDF, ePDFView, or other PDF viewer reachable
    through xdg-open
  - lpr or lp
  - QjackCtl (JACK Audio Connection Kit - Qt GUI Interface)
  - FLAC
  - WavPack
  - DSSI plugins (any your distro carries)
  - LADSPA plugins (any your distro carries)

User documentation
------------------

Please see rosegardenmusic.com


SPECIAL NOTES FOR PACKAGE MAINTAINERS
-------------------------------------

As of 10.02 all formerly optional dependencies are now mandatory dependencies.
We've taken this step because it is a real support hassle working through a set
of problems to finally uncover the reason something has broken is due to the
user's distro package being built without a particular feature turned on.

Most major distros already carry everything we depend on, so we don't anticipate
that the build requirements will be a serious irritation for package
maintainers.

Thank you for your cooperation, and thank you for making Rosegarden available to
our users!  If you need to patch Rosegarden for one reason or another in the
course of packaging it, please do keep upstream in the loop at
rosegarden-devel@lists.sourceforge.net or by contacting
michael.mcintyre@rosegardenmusic.com directly.  Thanks!

An older version of the appdata file is kept with the current version in
data/appdata.  It is named rosegarden.appdata-old.xml.


Authors and copyright
---------------------

Rosegarden is Copyright 2000-2018 The Rosegarden Development Team

See http://rosegardenmusic.com/resources/authors/ for a complete list of
developers past and present, and to learn something about the history of our
project.

Rosegarden is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.  See the file COPYING for more details.
