.\" generator: doxer.py 0.6
.\" generation: 2011\-04\-08T21:47:24
.TH "BEAST" "1" "2011\-04\-08 02:30:18 +0200" "beast\-0.7.3" "BEAST Manual Pages"

.SH
NAME


.PP
beast \- Music composition and modular synthesis application.
.SH
SYNOPSIS


.PP
\fBbeast\fP [\fIOPTIONS\fP] [\fIFILES...\fP]
.SH
DESCRIPTION


.PP
\fBbeast\fP is the BEtter Audio SysTem. It is a music composition and
modular synthesis application released as free software under the
GNU GPL and GNU LGPL.
.br

.br
\fBbeast\fP comes with various synthesis modules which can be arranged in
networks for modular synthesis. It is capable of monophonic and polyphonic
voice processing, provides MIDI sequencer functionality and supports
external sequencer sources. A huge set of extra modules is available through
the support for LADSPA (Linux Audio Developer's Simple Plugin API) plugins.
.br

.br
\fBbeast\fP's underlying sound engine \fIBSE\fP also comes with a scheme scripting
extension which allows for advanced non\-interactive processing via
bsescm(1) and creation of additional GUI functionality for \fBbeast\fP.
.SH
OPTIONS


.PP
\fBbeast\fP follows the usual GNU command line syntax, with long options starting with two dashes ('\-').
.br

.br



.TP
\fB\-\-skinrc\fP \fIFILENAME\fP 
.br
Read skin resources from \fIFILENAME\fP.

.TP
\fB\-\-print\-dir\fP \fIRESOURCE\fP 
.br
Print the directory for a specific resource (e.g. 'plugins' or 'images').
Giving just \fB\-\-print\-dir\fP without an extra argument causes \fBbeast\fP
to print the list of available resources.

.TP
\fB\-\-merge\fP 
.br
Causes the following files to be merged into the previous or first project.

.TP
\fB\-\-devel\fP 
.br
Enrich the GUI with hints useful for (script) developers

.TP
\fB\-h\fP, \fB\-\-help\fP 
.br
Shows a brief help message.

.TP
\fB\-v\fP, \fB\-\-version\fP 
.br
Prints out \fBbeast\fP and component versions and file paths.

.TP
\fB\-n\fP \fINICELEVEL\fP 
.br
Execute with priority \fINICELEVEL\fP, this option only takes effect for the root suid wrapper 'beast'.

.TP
\fB\-N\fP 
.br
Disables renicing to execute with existing priority.

.TP
\fB\-\-display\fP \fIDISPLAY\fP 
.br
X server display for the GUI; see X(7).

.TP
\fB\-\-bse\-latency\fP \fIUSECONDS\fP 
.br
Set the allowed synthesis latency for \fIBSE\fP in milliseconds.

.TP
\fB\-\-bse\-mixing\-freq\fP \fIFREQUENCY\fP 
.br
Set the desired synthesis mixing frequency in Hz.

.TP
\fB\-\-bse\-control\-freq\fP \fIFREQUENCY\fP 
.br
Set the desired control frequency in Hz, this should be much smaller than the
synthesis mixing frequency to reduce CPU load. The default value of approximately
1000 Hz is usually a good choice.

.TP
\fB\-\-bse\-pcm\-driver\fP \fIDRIVER\-CONF\fP 
.br

.TP
\fB\-p\fP \fIDRIVER\-CONF\fP 
.br
This options results in an attempt to open the PCM driver \fIDRIVER\-CONF\fP
when playback is started.
Multiple options may be supplied to try a variety of drivers and
unless \fIDRIVER\-CONF\fP is specified as 'auto', only the drivers
listed by options are used.
Each \fIDRIVER\-CONF\fP consists of a driver name and an optional comma
seperated list of arguments attached to the driver withan equal sign, e.g.:
\fB\-p oss=/dev/dsp2,rw \-p auto\fP

.TP
\fB\-\-bse\-midi\-driver\fP \fIDRIVER\-CONF\fP 
.br

.TP
\fB\-m\fP \fIDRIVER\-CONF\fP 
.br
This option is similar to the \fB\-\-bse\-pcm\-driver\fP option,
but applies to MIDI drivers and devices. It also may be specified multiple
times and features an 'auto' driver.

.TP
\fB\-\-bse\-driver\-list\fP 
.br
Produce a list of all available PCM and MIDI drivers and available devices.

.TP
\fB\-\-\fP 
.br
Stop argument processing, interpret all remaining arguments as file names.

.PP


.SS
Development Options:


.PP




.TP
\fB\-\-debug\fP \fIKEYS\fP 
.br
Enable certain verbosity stages.

.TP
\fB\-\-debug\-list\fP 
.br
List possible debug keys.

.TP
\fB\-:\fP[\fIflags\fP] 
.br
This option enables or disables various debugging specific flags for
beast core developers. Use of \fB\-:\fP is not recommended, because
the supported flags may change between versions and cause possibly
harmful misbehaviour.

.PP


.SS
Gtk+ Options:


.PP




.TP
\fB\-\-gtk\-debug\fP \fIFLAGS\fP 
.br
Gtk+ debugging flags to enable.

.TP
\fB\-\-gtk\-no\-debug\fP \fIFLAGS\fP 
.br
Gtk+ debugging flags to disable.

.TP
\fB\-\-gtk\-module\fP \fIMODULE\fP 
.br
Load additional Gtk+ modules.

.TP
\fB\-\-gdk\-debug\fP \fIFLAGS\fP 
.br
Gdk debugging flags to enable.

.TP
\fB\-\-gdk\-no\-debug\fP \fIFLAGS\fP 
.br
Gdk debugging flags to disable.

.TP
\fB\-\-g\-fatal\-warnings\fP 
.br
Make warnings fatal (abort).

.TP
\fB\-\-sync\fP 
.br
Do all X calls synchronously.

.PP


.SH
SEE ALSO


.PP
bsescm(1),
bse(5),
sfidl(1),
BEAST/BSE Website (http://beast.testbit.eu)