.TH "ecasoundrc" "5" "22\&.03\&.2009" "" "Multimedia software" .PP .SH "NAME" ecasoundrc \- ecasound rcfile .PP .SH "SYNOPSIS" {prefix}/share/ecasound/ecasoundrc (for instance \(cq\&/usr/local/share/ecasound/ecasoundrc\(cq\&) $HOME/\&.ecasound/ecasoundrc .PP .SH "DESCRIPTION" .PP \fBecasoundrc\fP 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 \fB\-R\fP option)\&. .PP The format is quite simple\&. One line consists of a configuration variable and its value\&. Variable and value are separated with either \(cq\&=\(cq\& or \(cq\& \(cq\&\&. Lines beginning with a \(dq\&#\(dq\& are ignored (comment lines)\&. .PP .SH "VARIABLES" .PP .IP "midi\-device" MIDI\-device\&. If the device name is given in \fIrawmidi,/dev/midi*\fP format, OSS/Linux or OSS/Lite drivers are used\&. Device \fIrawmidi,/dev/snd/midiCxDy\fP opens an ALSA raw\-MIDI device with card number \(cq\&x\(cq\& and device number \(cq\&y\(cq\&\&. See ecasound (1) man page (the \(cq\&\-Md option) for more info\&. Defaults to \fIrawmidi,/dev/midi\fP\&. .IP .IP "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 \(cq\&autodetect\(cq\& is specified, ecasound will try to auto\-detect a suitable device (JACK \-> ALSA \-> OSS \-> rtnull)\&. Defaults to \fIautodetect\fP\&. .IP .IP "default\-audio\-format" Default values for sample format, channel count, sampling rate and channel interleaving\&. Syntax is the same as used by ecasound\(cq\&s \fI\-f\fP option (see ecasound (1))\&. Defaults to \fIs16_le,2,44100,i\fP\&. .IP .IP "default\-to\-precise\-sample\-rates" Whether to ignore sample rate differences (and possibly avoid resampling)\&. Currently only affects OSS\-devices\&. Defaults to \fIfalse\fP\&. .IP .IP "default\-mix\-mode" If \fIdefault\-mix\-mode\fP is \fIsum\fP, engine will mix multiple channels into one output channel by summing all input channels\&. In mode \fIavg\fP, mixing is done by taking the average of all input channels\&. The \fIavg\fP mode is safe from clipping, while \fIsum\fP is closer to the way analog mixers work\&. Defaults to \fIavg\fP\&. .IP .IP "bmode\-defaults\-nonrt" Selects the default parameters to use with buffering mode \(cq\&nonrt\(cq\& (other modes are \(cq\&rt\(cq\& and \(cq\&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 \fI1024,false,50,false,100000,true\fP\&. .IP .IP "bmode\-defaults\-rt" See \(cq\&bmode\-defaults\-nonrt\(cq\&\&. Defaults to \fI1024,true,50,true,100000,true\fP\&. .IP .IP "bmode\-defaults\-rtlowlatency" See \(cq\&bmode\-defaults\-nonrt\(cq\&\&. Defaults to \fI256,true,50,true,100000,false\fP\&. .IP .IP "resource\-directory" Directory for global ecasound configuration files\&. Defaults to \fI{prefix\-dir}/share/ecasound\fP\&. Note! User\-specific resource files can be be stored to \(cq\&$(HOME)/\&.ecasound/\(cq\&\&. For instance you can add your own presets definitions to \(cq\&$(HOME)/\&.ecasound/effect_presets\(cq\&\&. .IP .IP "resource\-file\-genosc\-envelopes" Configuration file for generic oscillators\&. Is located in the resource directory\&. Defaults to \fIgeneric_oscillators\fP\&. .IP .IP "resource\-file\-effect\-presets" Configuration file for effect presets\&. Is located in the resource directory\&. Defaults to \fIeffect_presets\fP\&. .IP .IP "ladspa\-plugin\-directory" Directory containing LADSPA effect plugins\&. Defaults to \fI{prefix\-dir}/lib/ladspa\fP\&. If environment variable \fILADSPA_PATH\fP exists, directories specified in it are automatically searched for plugins\&. Note! To match the syntax of the \fILADSPA_PATH\fP environment variable, \(cq\&ladspa\-plugin\-directory\(cq\& can contain multiple directories, separated by \(cq\&:\(cq\& characters\&. .IP .IP "ext\-cmd\-text\-editor" If \fIext\-cmd\-text\-editor\-use\-getenv\fP is \fIfalse\fP or \(dq\&EDITOR\(dq\& is null, value of this field is used\&. .IP .IP "ext\-cmd\-text\-editor\-use\-getenv" Should ecasound try to query environment variable \(dq\&EDITOR\(dq\&\&. Defaults to \fItrue\fP\&. .IP .IP "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, \(dq\&%o\(dq\& 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, \fImpg123\fP is launched\&. .IP .IP "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 \fIlame\fP\&. As a special exception (added to Ecasound 2\&.7\&.0), if the output program is \(dq\&lame\(dq\& and options include \(dq\&\-\-big\-endian\(dq\&, Ecasound will detect this and output big\-endian samples\&. .IP .IP "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)\&. .IP .IP "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)\&. .IP .IP "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 \fImikmod\fP\&. .IP .IP "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 \fItimidity\fP\&. .IP .IP "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)\&. .IP .IP "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 \(cq\&signed\(cq\& or \(cq\&unsigned\(cq\&, and %E with either \(cq\&little\(cq\& or \(cq\&big\(cq\&\&. Double\-quotes and backslash\-espacing can be used to include white\-space to individual parameters\&. By default Ecasound will try to launch (flac)\&. .IP .IP "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 \fIfaad\fP\&. .IP .IP "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 \fIfaac\fP\&. .IP .SH "DEPRECATED" .PP .IP "ext\-cmd\-wave\-editor" .IP .SH "SEE ALSO" .PP ecasound (1), ecatools (1), ecasound\-iam (1) .PP .SH "AUTHOR" .PP Kai Vehmanen, >