Getting Started With 'Playfiles'

tutorial for setting up and running Max Mathews' Playfiles program
250B, CCRMA, Stanford, 2001

Matthew Burtner

1) copy the program files to a folder in your home directory

>mkdir hci
>cd hci
>cp ~mburtner/hci/* ~yourdirectoryname/hci

2) run the test programs

test the MIDI: this program allows you to toggle between a radio baton setup and a basic stamp setup.

>mkalsa testmidiplot
>a.out

test the audio: this program lets you know if audio is working. It generates a test tone

>mkalsa testaudio
>a.out

3) edit the playfiles program.

First you should choose, record, and save your .wav files into your hci directory. You will need to edit the playfiles C code to add your own soundfile names and possibly to add your own functionality.

>emacs playfiles.cpp

scroll down to where you see //sound file names. Change these lines from char *sound1="ex1.wav"; to char *sound1="yoursoundfilename.wav";

The program only runs .wav files at the present time.

in emacs: ctrl-s to save, ctrl-c to close

4) run the playfiles program

>mkalsa playfiles
>a.out

As the program starts, a new white window opens and the terminal window should say something like this:

loading sound files
region 1 ex1.wav OK
region 2 ex2.wav OK
region 3 ex3.wav OK
region 4 ex4.wav OK
region 5 ex5.wav OK
region 6 ex6.wav OK
region 7 ex7.wav OK
loading sound files complete

click on the new playfiles window so that the top bar turns blue. Now you can type commands to the program

s toggles scrub on and off
m toggles between the three cases: 0, 1, 2

5) quit the program: click back in the terminal window and type ctrl-c.