<insert file="../es-makrot.txt" /> <insert name="ecasound_indexbar" /> <p> <hr> <center><h2> ecasound documentation - manual pages </h2></center> </p> <html><head><title>ecasoundrc</title> <link rev="made" href="mailto:kai.vehmanen@wakkanet.fi"> </head> <body> <hr> <h1>ecasoundrc</h1> <h2>17.01.2003</h2> <p><h2>NAME</h2> ecasoundrc - ecasound rcfile <p><h2>SYNOPSIS</h2> {prefix}/share/ecasound/ecasoundrc (for instance '/usr/local/share/ecasound/ecasoundrc') $HOME/.ecasound/ecasoundrc <p><h2>DESCRIPTION</h2> <p><strong>ecasoundrc</strong> is the main configuration file for ecasound. Any user-specific modification should be done to $HOME/.ecasound/ecasoundrc, not to the global resource file. <p>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). <p><h2>VARIABLES</h2> <p><dl> <p><p></p><dt><strong>midi-device</strong><dd> MIDI-device. If the device name is given in <em>rawmidi,/dev/midi*</em> format, OSS/Linux or OSS/Lite drivers are used. Device <em>rawmidi,/dev/snd/midiCxDy</em> 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 <em>rawmidi,/dev/midi</em>. <p><p></p><dt><strong>default-output</strong><dd> Output device to use. Defaults to <em>/dev/dsp</em>. <p><p></p><dt><strong>default-audio-format</strong><dd> Default values for sample format, channel count, sampling rate and channel interleaving. Syntax is the same as used by ecasound's <em>-f</em> option (see ecasound(1)). Defaults to <em>s16_le,2,44100,i</em>. <p><p></p><dt><strong>default-to-precise-sample-rates</strong><dd> Whether to ignore sample rate differences (and possibly avoid resampling). Currently only affects OSS-devices. Defaults to <em>false</em>. <p><p></p><dt><strong>bmode-defaults-nonrt</strong><dd> 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 <em>1024,false,50,false,100000,true</em>. <p><p></p><dt><strong>bmode-defaults-rt</strong><dd> See 'bmode-defaults-nonrt'. Defaults to <em>1024,true,50,true,100000,true</em>. <p><p></p><dt><strong>bmode-defaults-rtlowlatency</strong><dd> See 'bmode-defaults-nonrt'. Defaults to <em>256,true,50,true,100000,false</em>. <p><p></p><dt><strong>resource-directory</strong><dd> Directory for global ecasound configuration files. Defaults to <em>{prefix-dir}/share/ecasound</em>. 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'. <p><p></p><dt><strong>resource-file-genosc-envelopes</strong><dd> Configuration file for generic oscillators. Is located in the resource directory. Defaults to <em>generic_oscillators</em>. <p><p></p><dt><strong>resource-file-effect-presets</strong><dd> Configuration file for effect presets. Is located in the resource directory. Defaults to <em>effect_presets</em>. <p><p></p><dt><strong>ladspa-plugin-directory</strong><dd> Directory containing LADSPA effect plugins. Defaults to <em>{prefix-dir}/lib/ladspa</em>. If environment variable <em>LADSPA_PATH</em> exists, directories specified in it are automatically searched for plugins. Note! To match the syntax of the <em>LADSPA_PATH</em> environment variable, 'ladspa-plugin-directory' can contain multiple directories, separated by ':' characters. <p><p></p><dt><strong>ext-cmd-text-editor</strong><dd> If <em>ext-cmd-text-editor-use-getenv</em> is <em>false</em> or "EDITOR" is null, value of this field is used. Defaults to <em>pico</em>. <p><p></p><dt><strong>ext-cmd-text-editor-use-getenv</strong><dd> Should ecasound try to query environment variable "EDITOR". Defaults to <em>true</em>. <p><p></p><dt><strong>ext-cmd-wave-editor</strong><dd> Command line for executing an external wave editor. Defaults to <em>snd</em>. <p><p></p><dt><strong>ext-cmd-mp3-input</strong><dd> 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 <em>mpg123 --stereo -r -b 0 -q -s -k %o %f</em>. <p><p></p><dt><strong>ext-cmd-mp3-output</strong><dd> 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 <em>lame -b %B -s %S -x -S - %f</em>. <p><p></p><dt><strong>ext-cmd-ogg-input</strong><dd> 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 <em>ogg123 -d raw --file=- %f</em>. <p><p></p><dt><strong>ext-cmd-ogg-output</strong><dd> 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 <em>oggenc -b %B --raw --raw-bits=%b --raw-chan=%c --raw-rate=%s --output=%f -</em>. <p><p></p><dt><strong>ext-cmd-mikmod</strong><dd> Command for starting mikmod input. Before execution, "%f" is replaced with file path, and %s with select sample rate. Defaults to <em>mikmod -d stdout -o 16s -q -f %s -p 0 --noloops %f</em>. <p><p></p><dt><strong>ext-cmd-timidity</strong><dd> Command for starting timidity++ input. Before execution, "%f" is replaced with file path. Defaults to <em>timidity -Or -o - %f</em>. <p></dl> <p><h2>SEE ALSO</h2> <p>ecasound(1), ecatools (1), ecasound-iam(1) <p><h2>AUTHOR</h2> <p>Kai Vehmanen, <<a href="mailto:kai.vehmanen@wakkanet.fi"><em>kai.vehmanen@wakkanet.fi</em></a>> <p><insert name="ecasound_tail" /> </body> </html>