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 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>>
22.03.2009 ecasoundrc(5)