## ecasound documentation - manual pages

# ecasoundrc

## 28.09.2001

## NAME

ecasoundrc - ecasound rcfile

## SYNOPSIS

$HOME/.ecasoundrc

## 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>