ecasoundrc is the main configuration file for ecasound.
Any user-specific modification should be done to
$HOME/.ecasound/ecasoundrc, not to the global resource file.
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 by default. If a chainsetup with zero
outputs, but with one or more inputs, is connected, a default output
is added and all the chains are connected to it. If the special-case
value 'autodetect' is specified, ecasound will try to auto-detect
a suitable device (JACK -> ALSA -> OSS -> rtnull).
Defaults to autodetect.
default-audio-format
Default values for sample format, channel count, sampling rate
and channel interleaving. Syntax is the same as used by
ecasound's -f option (see ecasound(1)).
Defaults to s16_le,2,44100,i.
default-to-precise-sample-rates
Whether to ignore sample rate differences (and possibly avoid
resampling). Currently only affects OSS-devices. Defaults to false.
bmode-defaults-nonrt
Selects the default parameters to use with buffering
mode 'nonrt' (other modes are 'rt' and 'rtlowlatency).
Parameters are given as a comma-separated tuple of values:
1) buffersize (number,-b), 2) raised priority (true/false,-r),
3) sched_priority (number,-r:X), 4) double buffering
(true/false,-z:db), 5) db-bufsize (number,-z:db,X), and
6) max intbuf (true/false,-z:intbuf). Defaults to
1024,false,50,false,100000,true.
bmode-defaults-rt
See 'bmode-defaults-nonrt'. Defaults to
1024,true,50,true,100000,true.
bmode-defaults-rtlowlatency
See 'bmode-defaults-nonrt'. Defaults to
256,true,50,true,100000,false.
resource-directory
Directory for global ecasound configuration files.
Defaults to {prefix-dir}/share/ecasound.
Note! User-specific resource files can be be stored
to '$(HOME)/.ecasound/'. For instance you can
add your own presets definitions to
'$(HOME)/.ecasound/effect_presets'.
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.
ladspa-plugin-directory
Directory containing LADSPA effect plugins. Defaults to {prefix-dir}/lib/ladspa.
If environment variable LADSPA_PATH exists, directories
specified in it are automatically searched for plugins.
Note! To match the syntax of the LADSPA_PATH environment
variable, 'ladspa-plugin-directory' can contain multiple
directories, separated by ':' characters.
ext-cmd-text-editor
If ext-cmd-text-editor-use-getenv is false or "EDITOR"
is null, value of this field is used. Defaults to pico.
ext-cmd-text-editor-use-getenv
Should ecasound try to query environment variable "EDITOR".
Defaults to true.
ext-cmd-wave-editor
Command line for executing an external wave editor. Defaults
to snd.
ext-cmd-mp3-input
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-cmd-mp3-output
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, %S with sample rate in kHz, and
%B with encoding bitrate in kbps. Defaults to lame -b %B -s %S -x -S - %f.
ext-cmd-ogg-input
Command for starting ogg input. All output should be directed
to standard output. Before execution, "%f" is replaced with
path to the input ogg. Defaults to ogg123 -d raw --file=- %f.
ext-cmd-ogg-output
Command for starting ogg output. All input data should be read
from standard input. Before execution, "%f" is replaced with
path to the output ogg, %c, %s and %b with equivalent
format parameters, and %B with encoding bitrate in kbps.
Defaults to oggenc -b %B --raw --raw-bits=%b --raw-chan=%c --raw-rate=%s --output=%f -.
ext-cmd-mikmod
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-cmd-timidity
Command for starting timidity++ input. Before execution, "%f"
is replaced with file path. Defaults to
timidity -Or -o - %f.