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
|
Additional Install Notes
------------------------
This document represents a *very* basic, hand-holding walkthrough of how to
install Tao. It's aimed primarily at OSX users who are unfamiliar with the
unix command line (it seems to me that linux and cygwin users are more
likely to know this stuff already), but for the most part it should apply to
all systems.
Things to Know:
---------------
- Tao is distributed as source code - this means that you'll first have to
compile it before you can use it, but don't worry, it's a relatively
simple process if you follow the below instructions.
- Tao uses a library called libaudiofile to write sound files.
Unfortunately this is not included by default with OSX, so you'll have
to install from the source code it yourself. If you're running linux or
cygwin, you'll be able to install it via your package manager, as it's a
fairly common library.
- Wherever you see something surrounded by single quotes ('), type it into
the terminal minus the quotes.
Installing libaudiofile (OSX only):
-----------------------------------
1.) Download the latest version of libaudiofile from here:
http://www.68k.org/~michael/audiofile/
2.) Unpack it somewhere on your home directory.
2.) Open a terminal (/Applications/Utilities/Terminal on OSX).
3.) Navigate to the new audiofile-... folder (to change directories from
a terminal, use the 'cd' (Change Directory) command,
e.g. 'cd libaudiofile' if the libary was in the libaudiofile folder).
4.) Now we need to configure the build process so that it installs correctly
for our system (because OSX is different to linux, ppc is different to
intel etc.). To do this we use the configure script included with
libaudiofile. By default, libaudiofile will be installed in
/usr/local/lib (this is a standard unix directory, but you'll find that
it's hidden from the Finder on OSX. It is possible to install it
elsewhere, but we won't be covering that here.
5.) To configure the build process, type './configure'. This will run the
configure script.
6.) You will see various lines of text as the configure script sets
everything up. When it's done (assuming it doesn't end in an error),
type 'make'. This compiles the library from it's source code.
7.) Again, you'll see a fair bit of text output to the terminal as
libaudiofile is compiled. When it's done (again, assuming it doesn't
end in an error message), you're ready to install it.
8.) You'll now have to become the administrator(root) user to install
libaudiofile. To do this on OSX, type 'sudo su -' (on *nix, type 'su', on
cygwin this step isn't necessary). You will be asked to enter the
administrator password, and then you will have administrator priviledges.
Before you continue, you will have to change directory again if you're
on OSX, so type (make sure you use the full path to libaudiofile this
time, i.e. '/Users/<your_name>/<path_to_libaudiofile>')
'cd <libaudiofile_path>'.
9.) Type 'make install'. This will copy the various files you've just
compiled over to your destination directory.
10.)Type 'exit' now, to return to your regular user priviledges.
Installing Tao:
---------------
1.) Unpack the Tao tarball somewhere (I'll assume you've already done this
if you're reading this file).
2.) In your terminal, change directory to the new tao directory. If you're
still in the libaudiofile directory, you will have to move up at least
one directory - to do this, '..' represents the parent directory for the
cd command (e.g. if tao is in the same parent directory as libaudiofile:
'cd ../tao-1.0-beta-<date>').
3.) The next steps are the same as for libaudiofile, so first run the
configure script as shown in step 4 above.
4.) Run make as above.
5.) Run 'make install' as above, making sure to change to administrator
priviledges if necessary.
6.) On OSX, you'll have to update your PATH environment variable so that the
system knows where to find the Tao executable. In a text editor, open the
.profile file in your home directory. It'll be a bit complicated to do
this with TextEdit, so you might find it easier to use the terminal-based
editor, pico. Run the command 'pico ~/.profile' in the Terminal, and
you'll see a basic text editor (for the shortcuts along the bottom, '^'
means the Ctrl key).
7.) Add the following line to the end of the file:
'export PATH=$PATH:/usr/local/bin'
This means that when you try to run a program from the terminal, it will
look in /usr/local/bin (as well as the other usual system paths) for the
command you entered, and run it if it can find it.
8.) Save the file and exit.
Running Tao:
------------
- cd to the examples subdirectory in the original tao directory, and type
'tao test' to build the test Tao script. If everything has installed
correctly, you should see some messages on the command line, then a
window will open displaying 4 Tao instruments.
- See the documentation in the doc subdirectory for how to use Tao.
- Niall Moody (9/5/06).
|
