ecasoundrc (5)

NAME

       ecasoundrc - ecasound rcfile

SYNOPSIS

       {prefix}/share/ecasound/ecasoundrc (for instance ´/usr/local/share/eca-
       sound/ecasoundrc´) $HOME/.ecasound/ecasoundrc

DESCRIPTION

       ecasoundrc is the main configuration file for ecasound.  Any  user-spe-
       cific 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  vari-
       able 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-audio-format
              Default  values  for sample format, channel count, sampling rate
              and channel interleaving. Syntax is the same  as  used  by  eca-
              sound´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_prior-
              ity (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.


       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)/.eca-
              sound/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 plug-
              ins.  Note! To match the syntax of the  LADSPA_PATH  environment
              variable,  ´ladspa-plugin-directory´ can contain multiple direc-
              tories, 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  -

       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.

SEE ALSO

       ecasound(1), ecatools (1), ecasound-iam(1)

AUTHOR

       Kai Vehmanen, <kai.vehmanen@wakkanet.fi>

                                  13.08.2003                     ecasoundrc(5)