-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
215 lines (153 loc) · 6.43 KB
/
INSTALL.txt
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
Composite - Live performance sequencing, sampling, and looping
BUILDING AND INSTALLING COMPOSITE
================================
Contents:
1. System Requirements
2. Download
3. Binary Packages
4. Prerequisites to Build from Source
5. Build and Install from Source (Simple)
6. Build and Install from Source (Detailed Configuration)
7. INSTALL.txt Changelog
1. System Requirements
----------------------
Composite is supported on the following operating systems:
* Linux/Unix/BSD
* Mac OS X
Composite is not yet supported on Windows because there are currently
no Windows developers on the project... and so the Windows components
have fallen into disrepair.(**)
Composite is known to work well on fairly old systems like this (as of
2009):
Pentium III 500 MHz
198 MB RAM
Consumer-Grade (cheap) audio card
Keyboard and Mouse
1x1 USB MIDI Interface (optional)
(**) - However, Gabriel recently acquired a couple Windows PC's,
so Windows support is coming. But it's not a priority
at the moment... since the LV2 plugin is the priority.
2. Download
-----------
Composite can be downloaded as a binary package, source distribution,
or you can check out the current development version with Subversion.
These can be accessed on the Composite home page:
http://gabe.is-a-geek.org/composite/
The source code for the current development version can be checked out
via Git:
$ git clone git://gitorious.org/composite/composite.git
3. Binary Packages
------------------
GNU/Linux:
Check your package management system for the package
'composite.' At this time there are no known distros
that have a package for Composite.
Mac OS X:
There are currently no Composite devs on OS X, so
neither are there any binary packages.
4. Prerequisites to Build from Source
-------------------------------------
In order to build from source, you will need the following libraries
installed on your system, and the development header files.
REQUIRED
* Qt 4 Library (>=4.5.0, 4.3.x might work, 4.2.x won't)
* Qt 4 SDK (moc, uic, etc.)
* GNU g++ compiler (>=4.0, 3.x might work)
* CMake (>= 2.6, earlier might work)
* pkg-config (Building without pkg-config may work, but
it's unsupported)
* JACK (jack1 >= 0.109.0, jack2 >= 1.9.3, earlier ones may
work on some systems)
* libsndfile >=1.0.17
* libarchive (Optional: libtar and libz)
* OS X: Xcode
* libFLAC for handling FLAC sound files.
* The boost libraries and the boost unit test framework.
OPTIONAL SUPPORT
* liblrdf for LADSPA plugins
On a single, 800MHz processor Composite takes about 37 min. to build.
On a dual-core, 64-bit, 2800MHz processor with gobs of memory it takes
about 2 min. to do a parallel build.
(**) These tests check that Tritium works correctly on your machine,
and with any changes the developers have added.
5. Build and Install from Source (Simple)
-----------------------------------------
After you have all the prerequisites, building and installing will
look like this:
$ tar xjf composite-0.008.tar.bz2
$ cd composite-0.008
$ mkdir build
$ cd build
$ cmake .. \
-DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_INSTALL_PREFIX=/usr/local \
-DWANT_LRDF=ON
$ make
$ sudo make install
+---------------------------------------------------+
| NOTICE: BUILDING WITH 'cmake .' IS NOT SUPPORTED |
+---------------------------------------------------+
On GNU/Linux and other unix-like systems, you'll also need to run:
$ sudo ldconfig
To change the directory where Composite is installed, it is done like
this on the last step:
$ sudo make install DESTDIR=/mnt/chroot
THERE IS NO UNINSTALL. USE A PACKAGE MANAGER.
Composite uses a tool that detects the correct Qt settings. Please
make sure that qmake for Qt4 is in your path... and all will be well.
___CREATING A BINARY PACKAGE___
If you are a package maintainer and wish for your packaging scripts to
be included in the Composite source tree, we would be happy to work
with you. Please contact the developer mailing list (see the Composite
home page). The instructions below are for the package systems that
have been contributed so far.
___CREATING A .DEB PACKAGE___
In order to create a .deb package for Debian or Debian-based systems
(like Ubuntu), you first need the debhelper package:
# apt-get install debhelper
To build the Composite package:
$ tar xjf composite-0.008.tar
$ cd composite-0.008
$ cd linux
$ fakeroot dpkg-buildpackage
This will place the .deb package and description files in the parent
directory. If you wish to change the version number for the archive,
edit linux/debian/changelog to set the version.
6. Build and Install from Source (Detailed Configuration)
---------------------------------------------------------
Unfortunately, CMake doesn't have something that works exactly like
'./configure --help' that will show you all the configuration
options. The best way to see the standard options is to run:
$ ccmake /path/to/sources/composite-0.008
Which will give you a listing of the options from the CMakeLists.txt
file. You have the following commands (and more) available:
h - get help on the current field/option
c - Reconfigure
g - Generate makefiles
t - Toggle advanced mode so that you can set
-funroll-loops -fomit-frame-pointer
The following information is for your convenience, and is bound to go
out-of date as things change:
DEBUG BUILDS -- Either `cmake -DCMAKE_BUILD_TYPE=Debug /path/to/srcs`
or `cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo /path/to/srcs`
LIBARCHIVE -- `cmake -DWANT_LIBARCHIVE=ON /path/to/srcs`
LRDF -- `cmake -DWANT_LRDF=ON /path/to/srcs`
PREFIX -- `cmake -DCMAKE_INSTALL_PREFIX=/usr/local /path/to/srcs`
DESTDIR -- With GNU Makefiles, `make install DESTDIR=/mnt/chroot`
7. INSTALL.txt Changelog
------------------------
2010-03-21 Gabriel M. Beddingfield <gabriel@teuton.org>
* Update all the versions to 0.008.
2010-03-14 Gabriel M. Beddingfield <gabriel@teuton.org>
* Add 'ldconfig' step after install.
* Fix error in cmake line, and expand.
* Add boost as a required lib.
* Update all the versions to 0.006.
2009-11-21 Gabriel M. Beddingfield <gabriel@teuton.org>
* Add Detailed build and install instructions.
2009-11-19 Gabriel M. Beddingfield <gabriel@teuton.org>
* Convert build system from scons to CMake.
2009-11-15 Gabriel M. Beddingfield <gabriel@teuton.org>
* Rebrand from Hydrogen to Composite
2009-04-08 Gabriel M. Beddingfield <gabriel@teuton.org>
* Create INSTALL.txt