/[svn]/web/trunk/www.linuxsampler.org/osx.html
ViewVC logotype

Contents of /web/trunk/www.linuxsampler.org/osx.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1618 - (show annotations) (download) (as text)
Thu Jan 3 21:15:16 2008 UTC (12 years, 8 months ago) by schoenebeck
File MIME type: text/html
File size: 7622 byte(s)
* minor restructuring of OSX howto

1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta content="text/html; charset=ISO-8859-1"
5 http-equiv="content-type">
6 <title>LinuxSampler For Mac OS X</title>
7 <link rel="shortcut icon" href="http://download.linuxsampler.org/favicon.ico" type="image/x-icon">
8 <link rel="stylesheet" type="text/css" href="libgig/css/content.css" title="content" media="all">
9 </head>
10 <body>
11 <h2><center>LinuxSampler for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>
12 <br>
13 <center>December&nbsp;18th,&nbsp;2007</center><br>
14 <div style="background-color: #F4F4FF; margin: 1em 3em 1em 3em; padding: 1em 1em 1em 2.2em;">
15 <a href="#intro">1.&nbsp; Introduction</a><br>
16 <a href="#requirements">2.&nbsp; Requirements</a><br>
17 <a href="#installation">3.&nbsp; Installation</a><br>
18 <a href="#using">4.&nbsp; Using the Applications</a><br>
19 <a href="#setup_midi">&nbsp;&nbsp;&nbsp;&nbsp;4.1&nbsp; Setting up MIDI Input</a><br>
20 <a href="#setup_audio">&nbsp;&nbsp;&nbsp;&nbsp;4.2&nbsp; Setting up Audio Output</a><br>
21 <a href="#load_samples">&nbsp;&nbsp;&nbsp;&nbsp;4.3&nbsp; Loading Samples</a><br>
22 <a href="#save_session">&nbsp;&nbsp;&nbsp;&nbsp;4.4&nbsp; Saving a Sampler Session</a><br>
23 <a href="#houston">5.&nbsp; Installation Troubleshooting</a><br>
24 <a href="#docs">6.&nbsp; Detailed Documentation</a><br>
25 <a href="#bugs">7.&nbsp; Bugs, Problems and Feature Requests</a><br>
26 <a href="#contact">8.&nbsp; Contact</a><br>
27 </div>
28
29 <a name="intro"></a>
30 <h3>1.&nbsp; Introduction</h3>
31 The LinuxSampler development team is happy to announce the release of
32 a new version of LinuxSampler of Mac OS X. More information will be added here soon, so check back frequently.<br>
33 <br>
34 For now the sampler supports the CoreMIDI interface
35 for MIDI input and <A HREF="http://www.jackosx.com">jack</A> for audio out. This means it currently runs only
36 as a standalone application. An AU/VST interface will follow at a later stage, along with
37 a network module to run multiple sampler slaves distributed on OS/X, Windows or
38 Linux machines (Linux provides better performance) all controlled from a
39 OS X or Windows box i.e. running the AU / VST sequencer.<br>
40 Even though LinuxSampler presently runs only as standalone app,
41 thanks to jack you can comfortably route the sampler's audio outs back into your sequencer.
42 <br>
43 LinuxSampler is implemented as a client/server application. This means
44 the sampling engine (the server / backend) runs
45 independently from the GUI (the client / frontend). Sampling engine and
46 client can be run on the same box or on different machines too, connected
47 over the network.<br>
48 <br>
49 The Mac OS X version provides all the features of the Linux version
50 since it is built from the same source code base.
51 This means when new features will come out the
52 Mac OS X version will usually provide the same feature set as the Linux
53 version. This was made possible by the very modular design of both
54 low level, operating system functions and flexible audio / MIDI driver
55 system.<br>
56 <br>
57 The Mac OS X version comes as an easy to install DMG file which will
58 install all the necessary modules to run both the server ( linuxsampler.exe )
59 and the GUI client. For now it installs only the qsampler GUI client
60 as JSampler, the sampler frontend written in Java requires Java 1.6 which is not
61 available on OS X yet. Of course you can run JSampler on a Windows or Linux box
62 connected over the network to your OS X box or you could try to run it in a windows
63 virtual machine. We discourage running a virtual machine along with the sampler
64 as both applicationes are very CPU and RAM hungry therefore the performance
65 of LinuxSampler will be suboptimal.
66
67
68
69 <a name="requirements"></a>
70 <h3>2.&nbsp; Requirements</h3>
71 <ul>
72 <li>PPC or Intel Mac (an Intel Mac should provide much better performance)
73 <li>Mac OS Tiger or later (Leopard should work too)</li>
74 <li><A HREF="http://www.jackosx.com">JackOSX</A>. Install it before LinuxSampler</li>
75 </ul>
76
77 <a name="installation"></a>
78 <h3>3.a&nbsp; Installation</h3>
79 <ol>
80 <li>Install <A HREF="http://www.jackosx.com">JackOSX</A>
81 (if you don't have it already).
82 </li>
83 <li>Download the latest version of the LinuxSampler Mac OS X installer
84 from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
85 Download Page</a>, and mount it on Finder.
86 </li>
87 <li>You will find a single folder "linuxsampler051-mac-20080102". Copy this
88 folder to wherever you like (e.g. under /Applications).
89 </li>
90 </ol>
91
92 <a name="using"></a>
93 <h3>4.&nbsp; Using the Applications</h3>
94 The folder contains three items, "bin", "linuxsampler" and
95 "qsampler". Double-click on qsampler. The application launches, and you
96 will see messages saying that linuxsampler is now running. After a
97 while, you will also see that the JackPilot application (installed by
98 the JackOSX installer) automatically launches showing the Jack server
99 already running.
100
101 <a name="setup_midi"></a>
102 <h3>4.1&nbsp; Setting up MIDI Input</h3>
103 In qsampler click on the device configuration tab.
104 Click on the MIDI devices icon and then on Create.
105
106 <br>
107 <br>
108 You can create an arbitrary number of MIDI input devices by repeating
109 the procedure above.
110 Each MIDI device can be routed to arbitrary sampler channels.
111
112 <a name="setup_audio"></a>
113 <h3>4.2&nbsp; Setting up Audio Output</h3>
114 LinuxSampler currently only supports the jack driver model for audio output
115 on Mac OS X.
116 Click on AUDIO devices icon and then on Create.
117 <br>
118 <br>
119
120
121 <a name="load_samples"></a>
122 <h3>4.3&nbsp; Loading Samples</h3>
123 Click on Add Channel. A dialog will appear.
124 Select the GIG file you want to load, the instrument within the GIG file,
125 Audio device, MIDI device, MIDI port and channel.
126 Click OK.
127 <a name="houston"></a>
128 <h3>5.&nbsp; Installation Troubleshooting</h3>
129 TODO
130
131 <a name="docs"></a>
132 <h3>6.&nbsp; Detailed Documentation</h3>
133 You find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
134 LinuxSampler documentation site</a>.
135
136 <a name="bugs"></a>
137 <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
138 There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.
139 Please report them using our bug tracking system:<br>
140 <br>
141 &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
142 <br>
143 Some bugs and problems we discovered so far:
144 <ul>
145 <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet
146 <br>
147 Toshi writes: I tried gigedit with X11 and gtk on my Mac. It worked, but the
148 installation process was too much complicated for ordinary users (so
149 complicated that I cannot remember exactly how I did that myself). We
150 still have a long way before gigedit can be part of binary distribution
151 for Mac.
152 </li>
153 <li>if you overload the sampler (CPU overload or disk overload) it
154 produces noises</li>
155 <li>
156 QSampler crashes when one tries to create a second port of jack.
157 An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes.
158 </li>
159 <li>
160 Another problem in QSampler. It sometimes fails to quit
161 gracefully, and I need to do "Force Quit". After force quitting, the
162 linuxsampler subprocess is still running and I need to stop it by
163 "killall linuxsampler".
164 </li>
165
166 </ul>
167
168 <a name="contact"></a>
169 <h3>8.&nbsp; Contact</h3>
170 If you have questions or want to help us to improve the sampler,
171 subscribe to the <a href="http://www.linuxsampler.org/developers.html">
172 LinuxSampler Developer's mailing list</a>.
173 <br><br>
174 That's it, enjoy!<br>
175 <br>
176
177 </body>
178 </html>

  ViewVC Help
Powered by ViewVC