Instructions on how to configure a laptop for LOrk activities, software to download and configure, and a collection of now standard LOrk repertory pieces. In progress, always...
Machine Setup and Software Repository Download
PLOrk software, with some documentation on how to configure a laptop for PLOrk-insanity!
First off, we work with MacBooks. Much of the ChucK code will probably work under Windows or LINUX, but you are on your own. This code and configuration has worked for us successfully under both Tiger and Leopard. If you know what you are doing, you can of course set things up differently, but don't yell at us if it doesn't work (please)!
==== Check your main hard-drive name. ==== If it has any spaces or unusual characters, problems are likely to arise. So, if it is called, inventively, "Macintosh HD", rename it "Macintosh_HD" or something else with no spaces. Or, if it is named, say, Løndal, try a name without the ø; unfortunately, characters seem to sometime cause problems with scripting.
==== Install RCEnvironment. ==== This allows you to create environmental variables that both Terminal apps (ChucK) and normal GUI apps (Max/MSP, miniAudicle, etc...) can access. We've found it important to be able to define a couple environmental variables for networking and other stuff.
Download this program and save it to the desktop. Open the disk image and double-click on the RCEnvironment.prefPane. It will prompt you to install the preferences pane, which you should do. Now open your system preferences and open the Environment Variables pane.
Define two important environmental variables.
Your Environmental Variables Control Panel will initially be empty of actual variables.
- Click on the + button in the lower left corner, and a new variable will appear in the list. For KEY, type NET_NAME. The VALUE field should be the same as your Sharing:Computer Name (e.g. "yourName"). Hit Save. Note that your computer name should not have any spaces, underscores (_), apostrophes, etc.
- Again, click on the + button, and define a second variable; for KEY, type LOrk_PATH, and for VALUE, put the path for wherever you want to store the PLOrk Repository directory. We keep it at the top of the main user directory, so the path would be /Users/[yourusername]/PLOrk (make sure there is NOT a forward slash at the end of this). You can, of course, put it elsewhere, and name the folder after your most awesome LOrk, as long as this variable contains the proper pathname (if you are unclear how to find the pathname for wherever you put this folder, simply click on it in the finder and hit command-i; the info panel will include a "Where" line, showing where the folder is located). Again, hit save, otherwise it won't, uh, get saved.
Your Environmental Variables control panel should look something like this. And your Network:Sharing control panel should like something like this (most important is that the top Computer Name be *exactly* the same thing as the NET_NAME environmental variable, and that it be a word without spaces).
(note: if you are a UNIX person, don't think you can bypass this and just set these variables in the terminal; unless you know something we don't -- which is likely -- then it won't work with GUI apps like the miniaudicle or Max/MSP.)
==== Logout and then log back in ==== (or reboot); this is necessary for these new variables to actually be initialized.
==== Do some Stuff in the Terminal application ==== (in /Applications/Utilities; NOTE: do NOT launch the Terminal from Spotlight; there is a bug in OSX that prevents it from loading system variables properly). Type (or copy/paste from here) the following command:
echo 'export PATH=$PATH:'$LOrk_PATH'/bin' >> ~/.bash_profile
(hit return), then
echo 'export PATH=$PATH:'$LOrk_PATH'/autoget' >> ~/.bash_profile
(and again, hit return) then try the command:
and make sure you see these lines (with your own user name, of course):
export PATH=$PATH:/Users/dan/PLOrk/bin export PATH=$PATH:/Users/dan/PLOrk/autoget
this shows the Terminal where to find Important PLOrk Thingies.
close the terminal (when reopened, these paths will be active) now, reopen the terminal and type:
and you should see a bunch of stuff, including lines something like:
LOrk_PATH=/Users/[your user name]/PLOrk NET_NAME=[your network sharing name]
and you should check Terminal's Preference Start-up panel for the following:
Shell opens with: (•) command (complete path) /bin/bash
done! this may seem like a pain, but it only has to do this once, per machine, and it makes MANY PLOrk endeavors much easier. we know. we've suffered. oh, how we've suffered.
if you are unsuccessful with this, it would probably be best to get some help from someone with UNIX experience; the PLOrk software needs these configuration specifications to work properly.
oh, i lied, there is one more thing:
==== Open the System Preferences:Sound control panel. ==== Select "Output" and choose the audio device that you want PLOrk sounds to come from. Maybe just the Internal Speakers, but maybe a nifty 6-channel audio interface that goes to an awesome hemispherical speaker that you built, maybe out of aluminum, or a salad bowl, or some other oddly shaped thingy. Probably should go ahead and set "Input" properly as well. Even better, install SoundSource.
Next, on the "Sound Effects" panel within the sound preferences, turn your alert volume all the way down; UNCHECK "Play user interface sound effects," "Play feedback when volume is changed," and "Play front row sound effects."
Open the System Preferences:Energy Saver control panel.
hit the "details" button (if you aren't already seeing details), make sure the computer is not set to go to sleep in anything less than an hour; it's annoying when the machine goes to sleep in the middle of a rehearsal.
Open the System Preferences:Security control panel.
go to the "firewall" tab, make sure the computer is set to "Allow all incoming connections"; this can save a step in tracking down OSC proplems. It may be a bad idea, but what the heck, this is PLOrk, let's live dangerously!
Downloading and Configuring the Repository
The PLOrk Repository is a collection of oft-performed PLOrk pieces and accessory files that we use regularly to maintain sanity. This is all minimally documented; we are working on improving documentation, but users of this software are encouraged to add documentation to these wiki pages.
- download the main repository
==== to configure... ==== do the following:
- put the main PLOrk directory in exactly where you specified for the LOrk_PATH variable (above); how about at the top of your main users directory? (/Users/[you]/PLOrk, or rename it after your own LOrk if you choose).
- put the NetworkCycler folder inside the "pieces" folder
- put the sfonts directory in the main PLOrk directory.
now, open the Terminal, and type the following command:
this will change your directory (cd) to the LOrk directory. If you get an error, then something isn't setup correctly.
and you should see the following:
bin doc lib pieces data examples misc sfonts
which is a list of all the directories in the PLOrk Repository.
these are UNIX commands; if you aren't familiar with some basic UNIX, it would be good to get used to it. see this unix tutorial; sections 1–5 should be enough.
Now, if you have previously installed Chuck, it is a good idea to remove that so you are sure you are using the most current Chuck, or, if you think your Chuck is cooler and more current than ours, go ahead and remove the Chuck binary in the PLOrk/bin directory. to remove the old Chuck, type:
sudo rm /usr/bin/chuck
and type in your user password. now, type:
and it will show you which version of chuck will be used. it should be in the PLOrk/bin directory, unless you are cooler than we are and have it elsewhere.
The files above represent a baseline installation for PLOrk software. The most up-do-date versions of each of the individual directories can be accessed and downloaded here.
getting started; droning, clicking away!
Let's start with the very first piece PLOrk EVER played, in our very first rehearsal, the Droner.
in the terminal, type:
droner.2 [your name]
which will start the stereo droner. if you are attached to a multichannel audio interface and an awesome 6-channel hemisphere, you can use the multichannel version of the Droner:
droner [your name]
you should see something like this:
~/PLOrk ~/PLOrk/bin number of output channels: 6 hello dan mouse ' Trackpad ' ready keyboard ' Apple Internal Keyboard / Trackpad ' ready "initial pitch <= " : (string)
if not, then something probably wasn't configured correctly. aaahhhhhhhhhhrrrrgrgrgrgrgrhhhhh.
To get some sound:
1. press the spacebar,
2. move the cursor to the upper left hand corner,
3. and start tilting the laptop. Improvise with tilting the laptop in various ways, and moving the cursor about. Listen.
you should hear a (surprise!)... DRONE. maybe not so interesting, but if you are near someone else also playing the Droner, then interesting things should start to happen; beating patterns and so on.
try pressing the number keys as well. if you are on a network with others playing the droner, they should see which key you pressed in the Terminal window.
when you are done, hit control-c (control and C keys together) in the Terminal to quit the droner.
now, let's try another piece, CliX. type:
or, if you are just using stereo:
after you see a few messages, begin typing. you should hear some cute little semi-pitched clikky thingies. if not, something ain't setup right. the cliks won't happen *exactly* when you type, at least not most of the time, and will seem to go on for a while after you type, if you type a lot of keys; this is OK! again, control-c in each window will get you out of the program.
if you are with another PLOrker, one (or more) of you type this:
clix [or clix.2, for stereo]
and the other type:
if you are both on the same network, then the first player(s) should be able to play CliX, receiving messages from the clix server (this is the normal way to play CliX)
and now, you should be ready to PLOrk!