Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 180 lines (101 sloc) 4.597 kb
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
1 'Csoundo' is a Csound library for Processing.
2
82d56b3 @jacobjoaquin Formatted README
authored
3 Copyright (c) 2010 Jacob Joaquin jacobjoaquin@gmail.com
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
4 http://csoundblog.com/
5
6 Note
7 ----
82d56b3 @jacobjoaquin Formatted README
authored
8
9 Csoundo development is in early Alpha. Though people have
10 been successful in running Csoundo on Linux, OS X and Windows, there
11 are still many issues that are preventing people from getting Csoundo
12 to work on their computers. For example, Csoundo only works with
13 the floats version of Csoundo, not doubles. (see "Known Issues" at
14 the end)
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
15
16
17
18 What is Processing?
19 -------------------
20
82d56b3 @jacobjoaquin Formatted README
authored
21 "Processing is an open source programming language and environment
22 for people who want to create images, animations, and interactions.
23 Initially developed to serve as a software sketchbook and to teach
24 fundamentals of computer programming within a visual context,
25 Processing also has evolved into a tool for generating finished
26 professional work. Today, tens of thousands of students, artists,
27 designers, researchers, and hobbyists who use Processing for learning,
28 prototyping, and production."
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
29
30 http://processing.org/
31
32
33
34 What is Csound?
35 ---------------
36
82d56b3 @jacobjoaquin Formatted README
authored
37 "Csound is a sound and music synthesis system, providing facilities
38 for composition and performance over a wide range of platforms. It
39 is not restricted to any style of music, having been used for many
40 years in the creation of classical, pop, techno, ambient, experimental,
41 and (of course) computer music, as well as music for film and
42 television."
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
43
44 http://csound.sourceforge.net/
45
46
47
48 Running on OS X
49 ---------------
82d56b3 @jacobjoaquin Formatted README
authored
50
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
51 1) Install Csound.
52
82d56b3 @jacobjoaquin Formatted README
authored
53 Only one version of the pre-built Csound binaries has been confirmed
54 to work on OS X, and only confirmed to work on Intel machines:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
55
56 csound5.12.4-OSX10.5-Universal.dmg
57 http://sourceforge.net/projects/csound/files/csound5/csound5.12/csound5.12.4-OSX10.5-Universal.dmg/download
58
59
82d56b3 @jacobjoaquin Formatted README
authored
60 2) Copy the Csoundo folder into your Processing 'libraries' folder.
61 See instructions at Processing.org:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
62
63 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
64
65
82d56b3 @jacobjoaquin Formatted README
authored
66 3) Copy or make a symlink to the csnd.jar file. The csnd.jar is
67 located here:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
68
69 /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar
70
71 Make a copy of csnd.jar in this folder:
72
73 yoursketchbook/libraries/csoundo/library
74
82d56b3 @jacobjoaquin Formatted README
authored
75 Alternatively, you can create a symbolic link using the terminal
76 app.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
77
82d56b3 @jacobjoaquin Formatted README
authored
78 $ cd yoursketchbook/libraries/csoundo/library $ ln -s
79 /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar
80 csnd.jar
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
81
82
83
84 Running on Linux
85 ----------------
86
82d56b3 @jacobjoaquin Formatted README
authored
87 I do not have linux installed. If you have better instructions,
88 please email me, and I will incorporate them into the Csoundo
89 knowledge base.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
90
91 1) Install Csound:
92
93 http://csound.sourceforge.net/
94
95
82d56b3 @jacobjoaquin Formatted README
authored
96 2) Copy the Csoundo folder into your Processing 'libraries' folder.
97 See instructions at Processing.org:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
98
99 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
100
101
102 3) Copy or make a symlink to the csnd.jar here:
103
104 yoursketchbook/libraries/csoundo/library
105
106 To create a symbolic link:
107
82d56b3 @jacobjoaquin Formatted README
authored
108 $ cd yoursketchbook/libraries/csoundo/library $ ln -s
109 /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar
110 csnd.jar
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
111
112
113 4) Make modifications to the 'processing' lauch script.
114
82d56b3 @jacobjoaquin Formatted README
authored
115 There is currently one known method for running Csoundo on linux.
116 That is, to make to modifications to the 'processing' launcher
117 script in the root folder of Processing.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
118
82d56b3 @jacobjoaquin Formatted README
authored
119 A. Towards the very end, right before the line "# Start Processing
120 in the same directory as this script", add this code (your csound
121 plugins folder may vary):
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
122
82d56b3 @jacobjoaquin Formatted README
authored
123 #make sure that OPCODEDIR is set.. export
124 OPCODEDIR=/usr/local/lib/csound/plugins log OPCODEDIR
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
125
82d56b3 @jacobjoaquin Formatted README
authored
126 B. Replace the last line "java processing.app.Base "$SKETCH" &" to
127 the following:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
128
82d56b3 @jacobjoaquin Formatted README
authored
129 java -Djava.library.path=/usr/local/lib processing.app.Base "$SKETCH"
130 &
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
131
132
133 Thanks to Rory Walsh for this info.
134
135
136
137 Running on Windows
138 ------------------
139
82d56b3 @jacobjoaquin Formatted README
authored
140 There have been reports of Csoundo working on various versions of
141 Windows. I do not have Windows installed. If you have better
142 instructions, please email me, and I will incorporate them into the
143 Csoundo knowledge base.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
144
145 1) Install Csound:
146
147 http://csound.sourceforge.net/
148
149
82d56b3 @jacobjoaquin Formatted README
authored
150 2) Copy the Csoundo folder into your Processing 'libraries' folder.
151 See instructions at Processing.org:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
152
153 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
154
155
156 3) Copy the csnd.jar here:
157
158 yoursketchbook/libraries/csoundo/library
159
160
161
162 Known Issues
163 ------------
164
82d56b3 @jacobjoaquin Formatted README
authored
165 * Csound Doubles is not yet supported. To find out which version
166 you are running, run csound, and about 5 lines down, you'll get a
167 message like this: "Csound version 5.12 (float samples) Jun 4 2010"
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
168
169 To track other issues, go here:
170
171 http://github.com/jacobjoaquin/Csoundo/issues
172
173
174
175
176
177
178
31ef440 @jacobjoaquin first commit
authored
179
Something went wrong with that request. Please try again.