Provided by: ecasound_2.9.1-7ubuntu2_amd64 bug

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

                                            22.03.2009                              ecasoundrc(5)