File: README

package info (click to toggle)
laborejo 0.8~ds0-2
  • links: PTS
  • area: main
  • in suites: buster, stretch
  • size: 13,260 kB
  • ctags: 2,211
  • sloc: python: 20,735; sh: 169; makefile: 5
file content (54 lines) | stat: -rw-r--r-- 3,247 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
=Laborejo - Music Notation Workshop=
===========Version 0.8==============
============June 2013===============
Laborejo, Esperanto for "Workshop", is used to craft music through notation.
It is is a graphical user interface for Lilypond, a MIDI creator and finally a tool collection to inspire and help you compose.

You get beautifully engraved notation through Lilypond and nice ways to control the playback without ever leaving a notation-based environment.

[Linux Instructions]
 Unpack or clone git, cd into the created directoy. Install all dependencies you want:
 Execute for the GUI:

    ./laborejo-qt

Or for the Collection Editor:

    ./laborejo-collection-editor

Use the --help parameter for more options:
    ./laborejo-qt --help
or
    ./laborejo-collection-editor --help

Then use the number- and cursor keys for immediate success!
And for a really good time use the numpad palette/numbers and change them with numpad-plus and numpad-minus.
Check Help->Manual for navigational and note/rest entry keys. Everything else is in the menus.

[Dependencies]
Laborejo is divided into a backend and an abstraction layer of functions, sometimes called API, and into several user interfaces including one Qt GUI.

Strictly spoken there is only one core dependency: Python 3.2 or higher. With that you can run command-line scripts and access all functions and data. Create, Load, Manipulate, Save, Batch-Convert, Playback and Export.

Additionally you should install the following optional dependencies. The Python dependencies must be build with and for Python 3 . If one is not available at runtime the feature will be deactivated, but you can still use everything else.

For a complete set of features you need to install

   -PyQt4 to run the Laborejo-Qt gui
   -Lilypond (>= 2.16) to generate and export PDF
   -a PDF Viewer, can be specified in the config or defaults to xdg-open
   -Without Lilypond or a PDF viewer you can use the LilyBin.com web upload command to see and share your scores.
   -PySMF for midi export
   -JACK Audio Connection Kit for MIDI-In and MIDI routing.
   -Calfbox - Playback and Jack Transport (compile, build the python module with "python3 setup.py build" and install it systemwide with "sudo python3 setup.py install".  Dependencies: GLib 2.0, libsmf, fluidsynth, libsndfile, libusb-1.0, libuuid . Please check if your distribution offers -devel packages of these, you need them, too.
   -Non Session Manager - For the ultimate audio production experience you want this system that stores and restores your whole setup including Laborejo, all synths and samplers and your jack connections. (Dependencies:  liblo,  pyliblo for Python3)

The dependencies above are really independent from each other. You can generate PDFs without the GUI, you can use the GUI without Lilypond. You can playback/generate MIDI without the GUI or Lilypond.

Some of these dependencies are relatively unknown and new. By the time Laborejo reaches the 1.0 milestone and gets accepted by a broad audience I hope distributions will be able to offer all packages in a convenient way.
Licensed under GPLv3 . Please read the fily COPYING for all involved licenses and packages.


[Contact]
http://www.laborejo.org
info@laborejo.org