Difference between revisions of "PLOrk Software Repository."

From CSWiki
Jump to: navigation, search
(The Repository)
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
PLOrk software, with some documentation on how to configure a laptop for PLOrk-insanity!
+
this has moved to:
----
 
  
=== Machine Configuration ===
+
http://wiki.cs.princeton.edu/index.php/PLOrk_Rep
 
 
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)!
 
 
 
'''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 a couple environmental variables for networking and other stuff.
 
 
 
[http://silvertone.princeton.edu/~skot/blork/RCEnvironment-1.3.X.dmg RCEnvironment-1.3.X.dmg]
 
or
 
[http://www.rubicode.com/Software/RCEnvironment/ at rubicode]
 
 
 
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.
 
 
 
'''2. 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. "your_name"). ''Hit Save.''
 
* 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. 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. Again, ''hit save'', otherwise it won't, uh, get saved.
 
 
 
Your Environmental Variables control panel should look something like [http://music.princeton.edu/~dan/plork/repository/envvars.jpg this]. And your Network:Sharing control panel should like something like [http://music.princeton.edu/~dan/plork/repository/sharing.jpg 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).
 
 
 
'''3. Logout and then log back in''' (or reboot); this is necessary for these new variables to actually be initialized.
 
 
 
'''4. Open the Terminal application''' (in /Applications/Utilities). Type 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:
 
 
 
* more ~/.bash_profile
 
 
 
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
 
 
 
close the terminal (when reopened, these paths will be active)
 
now, reopen the terminal and type:
 
 
 
* printenv
 
 
 
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]
 
 
 
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.
 
 
 
=== 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 here (coming)
 
* download the Network Cycler (coming), an additional piece that is not included in the main repository because it is kinda big (116mbytes).
 
* download the soundfonts directory (coming), which includes a bunch of soundfonts (sample collections) that are used in the Network Cycler and will be in other pieces. you can, of course, add other soundfonts or create your own and add them as well. this is also big (286mbytes), which is why it is kept separate.
 
 
 
* 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.
 

Latest revision as of 10:13, 28 January 2009

this has moved to:

http://wiki.cs.princeton.edu/index.php/PLOrk_Rep