Audicle : Build/Install Instructions

version: 1.0.x.x (quintesson)

home: http://audicle.cs.princeton.edu/


Installing the Executable

If you are using the executable, you only need to put audicle (osx) or audicle.exe (win32) somewhere convenient.

Installing for command line (optional)

To put audicle in your path so it can be launched from the command line, do the following:

In MacOS X: in Terminal, go to the bin/osx-universal/ directory and type: 

 %> sudo cp audicle /usr/bin/
    (enter your password when prompted)

 %> sudo chmod 755 /usr/bin/audicle


On Windows: put bin\win32\audicle.exe (and glut32.dll) in c:\windows\system32\.To run under windows: use start->run: cmd (or use cygwin)

At this point, you should be able to invoke audicle from either Terminal (in OSX) or 'cmd' under windows, from any directory.

Launching audicle:

Simply double-click on audicle (os x) or audicle.exe (windows).

or...

(if installed for command line) open a terminal and type 'audicle'

That's it for the binary release!



Building Audicle
  1. Go to the src/ directory (replace audicle-x.x.x.x with the actual directory name):

    %> cd audicle-x.x.x.x/src/

  2. If you type 'make' here, you should get the following message:

    %> make
   [audicle build]: please use one of the following configurations:
       make linux-oss, make linux-alsa, make linux-jack, 
       make osx, make osx-ub, or make win32

    Now, type the command corresponding to your platform... for example, for MacOS X (Universal Binary):

    %> make osx-ub

    or for Linux (Alsa):

    %> make linux-alsa

    etc...

  3. If you like, install audicle (cp into /usr/bin by default). If you don't like the destination, simply edit the makefile under 'install', or skip this step altogether.

    # (optional: edit the makefile first)
%> make install

  4. If you haven't received any error messages up to this point, then you should be done! There should be a 'audicle' executable in the current directory. For a quick sanity check, execute the following (use './audicle' if audicle is not in your path), and see if audicle runs:

    %> audicle

    (If you do get error messages during compilation, or you run into some other problem - please let us know and we will do our best to provide support.)

  5. You are ready to use Audicle!!! If this is your first time, you may want to look at the documentation, watch the audicle presentation, and (for your computer's safety) also try the command line chuck and the miniAudicle. Thank you very much. Happy ChucKing.

audicle | soundlab | cs | music