<--

-->

INSTALLING CECILIA

Debian GNU/Linux

• Install Tcl/Tk:
  
         apt-get install tcl8.3 tcl8.3-dev tk8.3 tk8.3-dev libfltk1 libfltk1-dev
  
  
• Install recommended software (sox, Rosegarden, Audacity):
  
         apt-get install sox rosegarden audacity
  
  
• Install Demudi software, if you use it (xsox, Audacity from CVS):
  
         apt-get install xsox audacity-cvs
  
  
• Install Csound: http://www.lakewoodsound.com/csound/hypertext/preface/install.htm
  
  
• Install Cecilia (Cecilia will install into /usr/local/bin and /usr/local/lib by default, edit the Makefile if you'd like it somewhere else):
  
         tar xzf cecilia-2.0.5.tar.gz
       cd cecilia-2.0.5
       su -
       make install

  
  
• If you install the program somewhere else, you must set CEC_LIBRARY to tell Celilia where to find her lib files. You can do this by adding the following line to the .cshrc file, if you use csh or tcsh, in your home directory:
  
         setenv CEC_LIBRARY ~/cecilia
  
      Or in your .profile if you use sh, ksh, or bash
  
         CEC_LIBRARY=~/cecilia; export CEC_LIBRARY
  

RedHat GNU/Linux

• Download this software from rpmfind.net or wherever:
  
      Tcl     Tk     sox     xsox     Rosegarden     Audacity
  
  
• Tcl and Tk are required, the rest are optional, but recommended.
  
  
• Install Csound:
  
         wget http://www.cs.bath.ac.uk/pub/dream/newest/csound-4.23-1.i386.rpm
       rpm -i csound-4.23-1.i386.rpm


  
• Install Cecilia (Cecilia will install into /usr/local/bin and /usr/local/lib by default, edit the Makefile if you'd like it somewhere else):
  
         tar xzf cecilia-2.0.5.tar.gz
       cd cecilia-2.0.5
       su -
       make install

  
  
• If you install the program somewhere else, you must set CEC_LIBRARY to tell Celilia where to find her lib files. You can do this by adding the following line to the .cshrc file, if you use csh or tcsh, in your home directory:
  
         setenv CEC_LIBRARY ~/cecilia
  
      Or in your .profile if you use sh, ksh, or bash
  
         CEC_LIBRARY=~/cecilia; export CEC_LIBRARY
  

SGI - IRIX

• You should have csound version3.47 installed and running on your machine. If not, the installation will check and use the default csound distribution that comes with CECILIA in the files directory.
• Make sure you have the correct version of CECILIA for your operating system (IRIX 5.x or IRIX 6.x).
• Gunzip and detar the CECILIA package in your home directory.
• If you have root priviledges, you can run the install.sh program. This will install CECILIA in the standard places (/usr/local/bin & usr/local/lib). This is the best solution for a multi-user network installation.
• If not, the installation will take place in the current CECILIA directory.
• If you choose to install the program somewhere else, you must indicate so by declaring a CEC_LIBRARY evironmental variable. You can do this by adding the following line to the .cshrc file in your home directory:

      setenv CEC_LIBRARY <where the cecilia directory will be found>
  

• Start up  CECILIA by typing cecilia in a shell or double-clicking on its icon.
• minimum recommended configuration: IRIX 5.3, 32Mb RAM, r4000sc CPU.

MacOS 8/9

• You should have perf 4.08 the csound engine part of Mill's Mac port, installed and running on your machine. Just to make sure, a copy of perf3.1.1 is included.
• the Mills Perf is identified by creator code, so make sure you don't have mutliple versions of it lying around, else the system will arbitrarily use one of them (you may either edit the codes for each version or simply compress unused versions).
• Start up  CECILIA by double-clicking on its icon.
• minimum recommended configuration: 32Mb RAM, 604 CPU.

MacOS X / Darwin

• Download and install the Tcl/Tk Aqua package. I use TclTkAqua-8.4.1.0-Jaguar.dmg and it works well for me.
  
  
• Download and install Csound. Install the files into /usr/local/bin
  
  
• Download and install Cecilia. Cecilia will install into /usr/local/bin and /usr/local/lib by default, edit the Makefile if you'd like it somewhere else:
  
         tar xzf cecilia-2.0.5.tar.gz
       cd cecilia-2.0.5
       su -
       make install

  
  
• If you install the program somewhere else, you must set CEC_LIBRARY to tell Celilia where to find her lib files. You can do this by adding the following line to the .cshrc file, if you use csh or tcsh, in your home directory:
  
         setenv CEC_LIBRARY ~/cecilia
  
      Or in your .profile if you use sh, ksh, or bash
  
         CEC_LIBRARY=~/cecilia; export CEC_LIBRARY
  

Windows

INSTALL

If you did nothing upon unpacking the self-extracting archive file (the file you downloaded), then Cecilia should have installed itself to the folder "c:\cecilia". Unless you have a very unusual windows setup, cecilia should work (but see the next section on configuration). No restart is necessary. Simple go to the folder "c:\cecilia" and double-click on the file "Cecilia" (the icon of which looks like, and is, a shortcut). Notice there is also a shortcut for the Cecilia Manual, which will call up the html documentation in your web browser.

If you really would like to put Cecilia somewhere other than "C:\cecilia", then you'll need to adjust the target and start-in fields of the cecilia shortcut. If that's sounds vague, then best stick to having cecilia at "C:\cecilia".

SETTING UP PREFERENCES (REQUIRED!)

Once you've launched cecilia, set the preferences from the file menu. The first two fields, "Winsound Exec" and "Csound Exec" are crucial; these should already point to the winsound.exe and csound.exe files that came with cecilia. Use the "set..." buttons to choose the right files if you need. The third field, "Soundfile Player:" should point to anything you'd like to use to play sound files. I like winamp (see below).

**** ALSO check that the fields "Temporary f:" and "SoundOut f:" point to a real folders. For example, win2000 users will likely need to change that to "c:\winnt\temp" or something. You'll get errors if this isn't right, and you won't be able to quit, so double check that.

Also in preferences, choose an "html viewer" with it's set button; browse to and choose your install of IExplorer or Netscape. This will allow the help system to function.

You may wish to set the default location of directories which Cecilia searchs in for soundfiles, analysis files, and snap shots, but it'll work without doing so.

**** From the Csound menu, set your OS from the sub menu at the bottom.

For a simple sound player/editor I recommend Audacity, available from our Cecilia website and set to install and interface right with Cecilia. Once you've called Audacity from Cecilia with one of the play buttons, you can leave Audacity open, and it won't interfere with Cecilia being able to output to the DAC, and it won't hog the audio driver, so you can open a soundfile editor (like Cool Edit!) and use all three concurrently.

UPDATING TO NEWER CSOUND VERSIONS

If you do download a new version of csound for cecilia, be sure to get both the winsound.exe and csound.exe console version (not the DOS version, which does look similar but does not support long files names). Both are required for Cecilia to work. These are usually titled csound_win.zip and csound_con.zip, respectively.

The html entrance to where csound is: http://www.cs.bath.ac.uk/~jpff/dream.html

the ftp location: ftp://earth.cs.bath.ac.uk/pub/dream/

Other Unix flavors

• There are no good reasons why CECILIA should not run under other Unix platforms. We just have not tested and/or adapted  them. Directions for the Linux install should be followed. If you do succeed in installing and running CECILIA on other Unix hardware, we would love to hear about it!

CECILIA v2.0 was developed by the authors on the following platforms:

• IRIX 6.2, 6.3
• Linux 2.0.33
• MacOS 7.6.1, 8.0, 8.1

It has since been developed and/or tested by the maintainers on the following platforms:

• Debian 2.4
• MacOS X
• Win98, Win98SE, Win2000Pro, and XP