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-samplerate
Default internal sample-rate used internally by the ecasound engine. Defaults to 44100.
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-interactive-mode
Whether to always use interactive mode (true or false). Same as the
the -c command line option. 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.
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 LADSPA 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, and %S with sample rate in kHz.
Defaults to lame -b 128 -s %S -x -S - %f.
ext-ogg-input-cmd
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 %f.
ext-ogg-output-cmd
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, and %c, %s and %b with equivalent
format parameters.
Defaults to oggenc -b 128 --raw --raw-bits=%b --raw-chan=%c --raw-rate=%s --output=%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.