How-to: Getting Started with ChucK

Setting Things Up

LINUX Machines at CCRMA

miniAudicle is already installed. Please do not try to build or compile the application by yourself.

  1. You might want to drag two applications - qjackctl and miniAudicle - to the task bar on the top of the desktop. If will create "Quick Launch" icons at the task bar.
  2. Start qjackctl a.k.a "Jack Control Panel" first. You can do this by running the command in a terminal:
     qjackctl & 
  3. Click Start button on the qjackctl window. Check if you can see "started" message on the qjackctl window.
  4. Start miniAudicle. NoteL There is no icon for miniAudicle in the Linux system. You MUST access it through the terminal by running the command:
     miniAudicle & 
  5. You are ready to use miniAudicle. (go to The First Program Section)

MacOS X

First off, You do not need "qjackctl" in OSX. However, you need to have miniAudicle installed on your computer. You can download the OS X version of miniAudicle from here. If you also wish to use Chuck from a terminal without miniAudicle, you can download it separately here

  1. Once you have downloaded the DMG file. Mount it on your desktop and copy miniAudicle executable to your Applications folder.
  2. If you open the mounted disk image on the desktop (you can open it by double-clicking), you will find an alias of examples folder. Double-click it and it will take you to the real examples folder. Copy and paste this folder to your desktop or wherever you want it to be. This is totally optional, but highly recommended because this folder contains many useful codes you can freely use.
  3. You surely want to create a shortcut for miniAudicle in your Dock.
  4. Launch miniAudicle
  5. You're all set. (go to The First Program Section)

WINDOWS

Windows installation is almost same with the OSX case. You can download the Windows version of miniAudicle from here. If you also wish to use Chuck from cmd.exe without miniAudicle, you can download it separately here

The First Program

  1. When miniAudicle launched, you should see 3 windows on your screen: Editor, Virtual Machine and Console Monitor. If you are missing something, you can open it in "Window" menu.
  2. Start audio engine by clicking Start Virtual Machine button on the virtual machine window. You should see your clock is ticking in the virtual machine. Otherwise, see the troubleshooting section.
  3. Type (or copy & paste) this example in the editor:
    SinOsc s => dac;
    0.2 => s.gain;
    1000 => s.freq;
    while ( true ) 1::day => now;
  4. Press Add Shred button in the editor to run the code. This will add the first "Shred" to the virtual machine producing audio samples to the audio output.
  5. You should hear a sine wave. Otherwise, see the troubleshooting section to get help.

More Programming Fun

Try these resources if you desperately want to use miniAudicle/ChucK for your musical needs.

  1. Unofficial ChucK User Forum at electro-eusic.com
  2. There are some examples you might want to dig in. They are included in the official miniAudicle release.
    examples/analysis
    examples/special
  3. Graham Coleman's most excellent tutorial on ChucK for Music