PLOrk Software Repository.
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, but you are on your own. This 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)!
1) 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
1.) In the Sharing System Preferences panel, make sure the "Computer Name" is a single word; "your_name" or some such. This is important for networking configuration.
2.) Create the following directories at the root level of the user directory:
~/ork (where ork is the name of the ensemble) ~/ork/users (in which each user maintains a dir with his/her files) ~/ork/bin (where executables like chuck, scripts, and other things can go) ~/ork/pieces (where finished pieces can reside) ~/ork/snd (a common directory for sound fonts and other shared soundfile resources) ~/ork/examples (a place to keep example and help files) ~/ork/misc (misc files related to the laptop ensemble)
alternatively, you can download our basic directory structure (which is like the above, but includes lots of good files) and install it in ~/ork (or whatever root directory you want). link for this coming soon....
3.) The bin dir above needs to be added to the search path for executables, as follows:
echo 'export PATH=$PATH:~/ork/bin' >> ~/.bash_profile
This command will ensure that the new ~/ork/bin directory is included in the search path for executables. Store Chuck here, along with any scripts.
4.) Set an environment variable for the Computer Name of the machine, as set in Step 1. The easiest way to accomplish this is to install the following preferences pane:
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.
Your window will initially be empty of actual variables. Now you will need to add an environment variable like the one above, except with the name of your machine. 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. "your_name"). You will need to logout/login or restart for this to actually take effect.
Also, note that typical UNIX ways of setting environmental variables don't seem to work for GUI apps, so using SETENV or some such in the terminal will work for ChucK, but not the Miniaudicle or Max/MSP. Oh, the things we learn the hard way...