ecatools - audio processing utils based on ecasound
SYNOPSIS
ecaconvert .extension file1 [ file2 ... fileN ]
ecafixdc file1 [ file2 ... fileN ]
ecalength file1 [ file2 ... fileN ]
ecamonitor [host][:port]
ecanormalize file1 [ file2 ... fileN ]
ecaplay [-dfhklopq] [ file1 file2 ... fileN ]
ecasignalview [ options ] [ input ] [ output ]
DESCRIPTION
Ecatools are simple command line utils for audio file processing.
Each tool is designed to perform one specific operation. Most of
the tools also support batch processing.
ECACONVERT
A tool for converting a set of files to a common target format.
This target format is given as the first command line
argument, and its syntax is .ext.
Ecamonitor is a util program that can be used
to monitor an active ecasound session. Ecamonitor
is able to show information about the current
chainsetup such as list of inputs, outputs,
current position, effects, the engine status
and numerous other things.
By default ecamonitor will try to connect
to IP4 address "localhost", to port "2868".
A different address can be specified when
starting ecamonitor, for example
"ecamonitor foo.mynetwork.com" or
"ecamonitor foo.mynetwork.com:4500".
To enable inbound connections, ecasound has to be
started with the --daemon option. Ecamonitor is
implemented in Python using the NetECI API.
ECANORMALIZE
Ecanormalize is a command-line tool for normalizing audio
files to utilize the full available sample resolution. Ecanormalize
first finds out how much the input file can be amplified without
clipping and if there is room for increase, a static gain will
be applied to the file.
ECAPLAY
Ecaplay is a command-line tool for playing audio files. Ecaplay
uses the libecasound engine and is thus able to handle all audio formats
supported by the library.
Files can be selected for playback either by specifying the
filenames on the command-line, or by using the playlist
mechanism. In playlist mode, files can be added to the playlist
using the -q option. The -p option can then be used
to play all tracks on the playlist. Ecaplay will repeat the
playlist tracks until explicitly stopped (with double Ctrl-C).
Playlist can be flushed with -f and its contents listed
with -l option.
If not otherwise specified, ecaplay will use the audio output device
specified in ~/.ecasound/ecasoundrc for playback. A different
output device can be selected with ECAPLAY_OUTPUT_DEVICE shell
environment variable or with the -o:output_device command-line
option.
Playback can be stopped at any time with Ctrl-C. If multiple
files are played, first Ctrl-C will stop the current file and move
on to play the next one. Issuing Ctrl-C twice (within one second),
will cause ecaplay to exit.
Flush the playlist contents. See also
options -l, -p and -q.
"-h"
Print usage information and exit.
"-k:number"
Skip 'number' of files.
"-l"
List the current playlist contents to stdout. See also
options -f, -p and -q.
"-o:output_device"
Use 'output_device' instead of the default output device
(as specified in ~/.ecasound/ecasoundrc). Syntax is same
as used by "-o" ecasound option (see ecasound(1) man page).
This option overrides the ECAPLAY_OUTPUT_DEVICE environment
variable (more info below).
"-p"
Play tracks in the playlist (in looped mode). See also
options -f, -l and -q.
"-q"
Queue new tracks to the playlist. All filenames given on
the command-line will be added to the the playlist. It is
possible to queue new tracks while another instance of
ecaplay is using the playlist. See also options -f, -l
and -p.
ECASIGNALVIEW
Ecasignalview is meant for monitoring signal amplitude and peak
statistics. It accepts the following options:
"input"
The first option not starting with a '-' is interpreted
as an input string. This can be a device or a filename. All formats
supported by libecasound are accepted. Defaults to '/dev/dsp'.
"output"
Similarly to input, second option not starting with a '-'
is interpreted as output. Defaults to 'null'.
"-b:buffersize"
Buffersize in sample frames. Defaults to 128.
"-c"
Enable cumulative mode. Counters are not reseted after refresh.
*deprecated*
"-d"
Enable debug mode.
"-f:format_string"
Specify default audio format. See ecasound(1) for details.
"-r:rate_msec"
Specify screen refresh rate in milliseconds.
It is possible to reset the max-peak and clipped-samples
counters by sending a SIGHUP signal to the process (i.e.
from another console: "killall -v -HUP ecasignalview").
More complete documentation for ecasignalview can be found
from "Ecasound User's Guide" (see ''http://www.eca.cx/ecasound
-> Documentation'').
ENVIRONMENT
ECASOUND
Path to the ecasound executable. Used by many ecatools.
ECAPLAY_OUTPUT_DEVICE
Device ecaplay should use for audio output. Same syntax
as for ecaplay/ecasound "-o" option.
FILES
~/.ecasound/ecasoundrc
The default ecasound resource file. See ecasoundrc(5)
for details.
~/.ecasound/ecaplay_queue
File used to store the ecaplay playlist (one track per
line with full path).