.TH synaesthesia 1 "10 May 2003" "" ""
.SH NAME
synaesthesia \- visual sound display
.SH SYNOPSIS
.B synaesthesia
[\-\-use\-sdl] [\-\-use\-x] [\-\-use\-svga] [\-\-fullscreen]
[\-\-width w] [\-\-height h]
.IR input
.SH DESCRIPTION
Synaestheia is a program for representing audio graphically in real time using
an attractive variety of visual effects.  It reads sound data from
.IR input
and displays the visual representation through svgalib, X or SDL.
.PP
While synaesthesia is running, moving the mouse over the window will expose
a set of audio and other runtime controls.

.TP
\fB\-\-use\-sdl\fR
Force display via SDL.
.TP
\fB\-\-use\-svga\fR
Force display via svgalib (i386 architecture only).
.TP
\fB\-\-use\-x\fR
Force display via X.
.TP
\fB\-\-fullscreen\fR
Attempt a full-screen display (requires a fast machine).
.TP
\fB\-\-width\fR \fIw\fR
Specify a width for the window.
.TP
\fB\-\-height\fR \fIh\fR
Specify a height for the window.
.TP
\fIinput\fR as \fBcd\fR | \fBline\fR | \fBesd\fR | \fBpipe\fB \fIfrequency\fR
Audio source; this should be one of \fIcd\fR, \fIline\fR, \fIesd\fR, or
\fIpipe\fR.  When using a \fIpipe\fR source, the sample frequency (e.g.
44100) must be specified; synaesthesia will expect a 16-bit stereo
PCM stream on standard input.  The sound will be played to the audio device.

.SH EXAMPLES
.BR
.IP "synaesthesia esd"
.IP "synaesthesia cd"
.IP "synaesthesia line"
.IP "ogg123 -d raw -f - song.ogg | synaesthesia pipe 44100"

.SH AUTHOR
.PP
Synaesthesia was written by Paul Harrison <pfh@csse.monash.edu.au>.
.PP
This manual page was written by Devin Carraway <devin@debian.org> for the
Debian GNU/Linux system (but may be used by others).