NAME¶
ecasoundrc - ecasound rcfile
SYNOPSIS¶
{prefix}/share/ecasound/ecasoundrc (for instance
’/usr/local/share/ecasound/ecasoundrc’) $HOME/.ecasound/ecasoundrc
DESCRIPTION¶
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. Ecasound also allows one to disable the normal policy and only
read from a specific resource file (see ecasound (1) and documentation for the
-R option).
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 (1) 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.
- default-mix-mode
- If default-mix-mode is sum, engine will mix
multiple channels into one output channel by summing all input channels.
In mode avg, mixing is done by taking the average of all input
channels. The avg mode is safe from clipping, while sum is
closer to the way analog mixers work. Defaults to avg.
- 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.
- ext-cmd-text-editor-use-getenv
- Should ecasound try to query environment variable
"EDITOR". Defaults to true.
- ext-cmd-mp3-input
- Command for starting mp3 input. Ecasound expects to read
signed, 16bit, little-endian stereo audio samples from its standard input.
Ecsound will query other audio format parameters by parsing the mp3 file
header. Before execution, %f is replaced with path to the input mp3. If
exists, "%o" is replaced with he start offset in mp3 frames.
Double-quotes and backslash-espacing can be used to include white-space to
individual parameters. By default, mpg123 is launched.
- ext-cmd-mp3-output
- Command for starting mp3 output. Ecasound will write
stereo, signed, 16bit, little-endian samples to standard output. Sample
rate is configurable. Before execution, %f is replaced with path to the
output mp3, %S with sample rate in kHz, and %B with encoding bitrate in
kbps. Double-quotes and backslash-espacing can be used to include
white-space to individual parameters. By default Ecasound will try to
launch lame. As a special exception (added to Ecasound 2.7.0), if
the output program is "lame" and options include
"--big-endian", Ecasound will detect this and output big-endian
samples.
- ext-cmd-ogg-input
- Command for starting Ogg Vorbis input. Ecasound expects
that audio samples are written to standard output. It should be noted that
Ecasound is not able to query the audio format parameters from ogg files,
so these need to be set manually by the user. Before execution, %f is
replaced with path to the input ogg. Double-quotes and backslash-espacing
can be used to include white-space to individual parameters. By default
Ecasound will try to launch (ogg123).
- ext-cmd-ogg-output
- Command for starting Ogg Vorbis output. Ecasound will write
samples in little-endian format to standard output. Other audio parameters
are configurable. Before execution, %f is replaced with path to the output
ogg, %c, %s and %b with matching audio format parameters, and %B with
encoding bitrate in kbps. Double-quotes and backslash-espacing can be used
to include white-space to individual parameters. By default Ecasound will
try to launch (oggenc).
- ext-cmd-mikmod
- Command for starting mikmod input. Ecasound expects that
signed, 16bit, stereo audio samples are written to standard output. Before
execution, %f is replaced with file path, and %s with selected sample
rate. Double-quotes and backslash-espacing can be used to include
white-space to individual parameters. By default Ecasound will try to
launch mikmod.
- ext-cmd-timidity
- Command for starting timidity++ input. Ecasound expects
that signed, 16bit, stereo audio samples are written to standard output.
Before execution, %f is replaced with file path, and %s with sample rate.
Double-quotes and backslash-espacing can be used to include white-space to
individual parameters. By default Ecasound will try to launch
timidity.
- ext-cmd-flac-input
- Command for starting FLAC input. Ecasound expects that
audio samples are written to standard output. It should be noted that
Ecasound is not able to query the audio format parameters from FLAC files,
so these need to be set manually by the user. Before execution, %f is
replaced with path to the input FLAC file. Double-quotes and
backslash-espacing can be used to include white-space to individual
parameters. By default Ecasound will try to launch (flac).
- ext-cmd-flac-output
- Command for starting FLAC output. Ecasound will write
samples to standard output. All audio parameters are configurable. Before
execution, %f is replaced with path to the output flac, %c, %b and %s with
matching audio format parameters, %I with either ’signed’ or
’unsigned’, and %E with either ’little’ or
’big’. Double-quotes and backslash-espacing can be used to
include white-space to individual parameters. By default Ecasound will try
to launch (flac).
- ext-cmd-aac-input
- Command for starting AAC input. Ecasound expects that
signed, 16bit, stereo, big-endian audio samplesare written to standard
output. It should be noted that Ecasound is not able to query the input
sample rate, so this needs to be set manually by the user. Before
execution, %f is replaced with path to the input AAC file. Note! FAAC must
be compiled with MP4 support. Double-quotes and backslash-espacing can be
used to include white-space to individual parameters. By default Ecasound
will try to laucnh faad.
- ext-cmd-aac-output
- Command for starting AAC output. Ecasound will write
big-endian audio samples to standard output. All other audio parameters
are configurable. Before execution, %f is replaced with path to the output
AAC file, %c, %b and %s with matching audio format parameters. Note! FAAC
must be compiled with MP4 support. Double-quotes and backslash-espacing
can be used to include white-space to individual parameters. By default
Ecasound will try to launch faac.
DEPRECATED¶
- ext-cmd-wave-editor
-
SEE ALSO¶
ecasound (1), ecatools (1), ecasound-iam (1)
AUTHOR¶
Kai Vehmanen, <kvehmanen -at- eca -dot- cx <kvehmanen -at- eca -dot-
cx>>