ecasoundrc

28.09.2001

NAME

SYNOPSIS

DESCRIPTION

ecasoundrc is the main configuration file for ecasound. If it doesn't exist, ecasound creates it with default values. If it exists, all name-value pairs are read. When you quit ecasound, ecasoundrc is rewritten if resource values have been modified.

The format is quite simple. One line consists of a configuration variable and its value. Variable and value are separated with either '=' or ' '. Lines beginning with a "#" are ignored (comment lines).

VARIABLES

midi-device

MIDI-device. If the device name is given in rawmidi,/dev/midi* format, OSS/Linux or OSS/Lite drivers are used. Device rawmidi,/dev/snd/midiCxDy opens an ALSA raw-MIDI device with card number 'x' and device number 'y'. See ecasound(5) man page (the '-Md option) for more info. Defaults to rawmidi,/dev/midi.

default-output

Output device to use. Defaults to /dev/dsp.

default-buffersize

Sets the size of buffer in samples (must be an exponent of 2). Same as the -b command line options. Defaults to 1024.

default-double-buffer-size

Set buffersize for double-buffering (-z:db, see below). Defaults to 100000.

default-to-interactive-mode

Whether to always use interactive mode (true or false). Same as the the -c command line option. Defaults to false.

default-to-raisepriority

Whether to always raise runtime priority (true or false). Same as the the -r command line option. Defaults to false.

default-to-double-buffering

Whether to used advanced double-buffering with audio inputs that support it. Defaults to false.

default-to-precise-sample-rates

Whether to ignore sample rate differences (and possibly avoid resampling). Currently only affects OSS-devices. Defaults to false.

default-to-max-internal-buffering

Whether to allow realtime devices to utilize extra internal buffering. Enabling this improves reliability, but at the same time causes additional latency to the signal processing chain. Can be overridden with -z:intbuf and -z:nointbuf options. Defaults to true.

resource-directory

Directory for global ecasound configuration files. Defaults to {prefix-dir}/share/ecasound.

resource-file-genosc-envelopes

Configuration file for generic oscillators. Is located in the resource directory. Defaults to generic_oscillators.

resource-file-effect-presets

Configuration file for effect presets. Is located in the resource directory. Defaults to effect_presets.

user-resource-directory

Directory for user-specific ecasound configuration files. If this directory exists, ecasound will search for filenames assigned to global resources (specified with resource-file-*). Defaults to ~/ecasound-config.

internal-plugin-directory

Directory containing ecasound's internal plugins. Defaults to {prefix-dir}/lib/ecasound-plugins.

ladspa-plugin-directory

Directory containing LADPSA effect plugins. Defaults to {prefix-dir}/lib/ladspa. If environment variable LADSPA_PATH exists, directories specified in it are automatically searched for plugins.

ext-text-editor

If ext-text-editor-use-getenv is false or "EDITOR" is null, value of this field is used. Defaults to pico.

ext-text-editor-use-getenv

Should ecasound try to query environment variable "EDITOR". Defaults to true.

ext-wave-editor

Command line for executing an external wave editor. Defaults to snd.

ext-mp3-input-cmd

Command for starting mp3 input. All output should be directed to standard output. Before execution, "%f" is replaced with path to the input mp3. If exists, "%o" is replaced with the start offset in mp3 frames. Defaults to mpg123 --stereo -r -b 0 -q -s -k %o %f.

ext-mp3-output-cmd

Command for starting mp3 output. All input data should be read from standard input. Before execution, "%f" is replaced with path to the output mp3. Defaults to lame -b 128 -x -S - %f.

ext-mikmod-cmd

Command for starting mikmod input. Before execution, "%f" is replaced with file path, and %s with select sample rate. Defaults to mikmod -d stdout -o 16s -q -f %s -p 0 --noloops %f.

ext-timidity-cmd

Command for starting timidity++ input. Before execution, "%f" is replaced with file path. Defaults to timidity -Or -o - %f.

SEE ALSO

ecasound(1), qtecasound (1), ecatools (1), ecasound-iam(1)

AUTHOR

Kai Vehmanen, <kaiv@wakkanet.fi>