This is the README for Common Music.

Documentation, examples and tutorials are located under the doc/ directory.   For an overview of the system start with the doc/cm.html home page and follow the documentation links.  To read about MIDI support under the various operating systems see doc/MIDI.TEXT and the MIDI documentation in the main dictonary.  Release notes can be found in doc/changes.text and an installation guide in doc/install.html.  

Common Music is released in both source and binary formats:

Source Downloads:

CCMRA:
  MacOS (PPC) ftp://ftp-ccrma.stanford.edu/pub/Lisp/cm/sources/cm.sea.bin
  NT/Win95    ftp://ftp-ccrma.stanford.edu/pub/Lisp/cm/sources/cm.zip
  Unix/Linux  ftp://ftp-ccrma.stanford.edu/pub/Lisp/cm/sources/cm.tar.gz

UIUC:
  MacOS (PPC) http://www-camil.music.uiuc.edu/software/cm/sources/cm.sea.bin
  NT/Win95    http://www-camil.music.uiuc.edu/software/cm/sources/cm.zip
  Unix/Linux  http://www-camil.music.uiuc.edu/software/cm/sources/cm.tar.gz

Binary Downloads:

CCMRA:
  MacOS (PPC) ftp://ftp-ccrma.stanford.edu/pub/Lisp/cm/binaries/cm-ppc.sea.bin
  NT/Win95    ftp://ftp-ccrma.stanford.edu/pub/Lisp/cm/binaries/cm-win32.zip
UIUC:
  MacOS (PPC) http://www-camil.music.uiuc.edu/software/cm/binaries/cm-ppc.sea.bin
  NT/Win95    http://www-camil.music.uiuc.edu/software/cm/binaries/cm-win32.zip

The binary release of Common Music contains a runtime image plus all
system documentation and example files. Binary releases are a bit
different depending on the current state of CM for a given OS/Lisp
combination. At a minumum, all ports contain the basic kernel and can
generate MIDI and CSound score files. The differences are summarized
in this table:

        Lisp     Compiler?  Csound?  CLM?      MIDIFile? MIDIRealtime?
        -------------------------------------------------------------
MacOS:  MCL 4.2  no         yes      no        yes       yes(OMS)
Win32:  CLISP    byte       yes      no        yes       no

To use some other combination of features (such as a compiler in MCL),
or to include syntaxeS other than the ones listed here you will need
to ftp the sources and build the system yourself.


Macintosh Notes

MIDI real time support requires that the Opcode Midi System be installed.  You can download OMS from http://www.opcode.com/downloads/oms/mac/


Linux Notes:
 
CLM Audio support requires that the OSS sound drivers be installed.  You can download the OSS drivers from http://www.4front-tech.com.  The oss download also contains mplay, a shell command that can play midi files from CM (See *midifile-player* entry in the dictionary.)

Emacs Notes:

If you are on a Unix or WIndows machine the easiest way to work with Common Music is running it as a subprocess of Emacs or XEmacs. You can download XEmacs from http://www.xemacs.org/
An Emacs for Windows/NT can be found at http://www.cs.washington.edu/homes/voelker/ntemacs.html
See cm/site/_emacs for an example of an Emacs init file.