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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1616 - (hide annotations) (download) (as text)
Thu Jan 3 20:38:22 2008 UTC (16 years, 2 months ago) by schoenebeck
File MIME type: text/html
File size: 7697 byte(s)
- replaced copy&pasted windows icon by Apple's icon
  in the OSX howto

1 senoner 1614 <!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 schoenebeck 1616 <h2><center>LinuxSampler for Mac OS X &nbsp; <img src="gfx/logos/apple.png"> &nbsp; HOWTO by Toshi Nagata&nbsp;</center></h2>
12 senoner 1614 <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 senoner 1615 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 senoner 1614 <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 senoner 1615 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 senoner 1614 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 senoner 1615
69 senoner 1614 <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     Simply download the latest version of the LinuxSampler Mac OS X installer
80     from the <a href="http://www.linuxsampler.org/downloads.html">LinuxSampler
81 senoner 1615 Download Page</a>, <br>
82     and mount it on Finder. You
83     will find a single folder "linuxsampler051-mac-20080102". Copy this
84     folder to wherever you like (e.g. under /Applications).
85     <br>
86     The folder contains three items, "bin", "linuxsampler" and
87     "qsampler". Double-click on qsampler. The application launches, and you
88     will see messages saying that linuxsampler is now running. After a
89     while, you will also see that the JackPilot application (installed by
90     the JackOSX installer) automatically launches showing the Jack server
91     already running.
92 senoner 1614
93    
94     <a name="using"></a>
95     <h3>4.&nbsp; Using the Applications</h3>
96     Now that we installed everything, let's get wet and start the applications:
97     <ol>
98 senoner 1615 <li>Start QSampler, the GUI frontend. It should automatically start LinuxSampler the backend application</li>
99 senoner 1614 </ol>
100     </div>
101    
102     <a name="setup_midi"></a>
103     <h3>4.1&nbsp; Setting up MIDI Input</h3>
104     In qsampler click on the device configuration tab.
105     Click on the MIDI devices icon and then on Create.
106    
107     <br>
108     <br>
109     You can create an arbitrary number of MIDI input devices by repeating
110     the procedure above.
111     Each MIDI device can be routed to arbitrary sampler channels.
112    
113     <a name="setup_audio"></a>
114     <h3>4.2&nbsp; Setting up Audio Output</h3>
115     LinuxSampler currently only supports the jack driver model for audio output
116     on Mac OS X.
117     Click on AUDIO devices icon and then on Create.
118     <br>
119     <br>
120    
121    
122     <a name="load_samples"></a>
123     <h3>4.3&nbsp; Loading Samples</h3>
124     Click on Add Channel. A dialog will appear.
125 senoner 1615 Select the GIG file you want to load, the instrument within the GIG file,
126 senoner 1614 Audio device, MIDI device, MIDI port and channel.
127     Click OK.
128     <a name="houston"></a>
129     <h3>5.&nbsp; Installation Troubleshooting</h3>
130    
131    
132     <a name="docs"></a>
133     <h3>6.&nbsp; Detailed Documentation</h3>
134     You find more detailed documentation about our software on our official <a href="http://linuxsampler.org/documentation.html">
135     LinuxSampler documentation site</a>.
136    
137     <a name="bugs"></a>
138     <h3>7.&nbsp; Bugs, Problems and Feature Requests</h3>
139     There could be several bugs in the Mac OS X version of LinuxSampler which we hope to root out soon.
140     Please report them using our bug tracking system:<br>
141     <br>
142     &nbsp;&nbsp;&nbsp;&nbsp;<a href="http://bugs.linuxsampler.org/">http://bugs.linuxsampler.org/</a><br>
143     <br>
144     Some bugs and problems we discovered so far:
145     <ul>
146     <li>The current LinuxSampler for Mac OS X binary distribution does not ship with gigedit yet
147     <br>
148     Toshi writes: I tried gigedit with X11 and gtk on my Mac. It worked, but the
149     installation process was too much complicated for ordinary users (so
150     complicated that I cannot remember exactly how I did that myself). We
151     still have a long way before gigedit can be part of binary distribution
152     for Mac.
153     </li>
154     <li>if you overload the sampler (CPU overload or disk overload) it
155     produces noises</li>
156     <li>
157     QSampler crashes when one tries to create a second port of jack.
158     An error dialog saying the device was not created, after the dialog is dismissed the QSampler crashes.
159     </li>
160     <li>
161     Another problem in QSampler. It sometimes fails to quit
162     gracefully, and I need to do "Force Quit". After force quitting, the
163     linuxsampler subprocess is still running and I need to stop it by
164     "killall linuxsampler".
165     </li>
166    
167     </ul>
168    
169     <a name="contact"></a>
170     <h3>8.&nbsp; Contact</h3>
171     If you have questions or want to help us to improve the sampler,
172     subscribe to the <a href="http://www.linuxsampler.org/developers.html">
173     LinuxSampler Developer's mailing list</a>.
174     <br><br>
175     That's it, enjoy!<br>
176     <br>
177    
178     </body>
179     </html>

  ViewVC Help
Powered by ViewVC