1
.TH "ecatools" "1" "12\&.11\&.2005" "" "Multimedia software"
5
ecatools \- audio processing utils based on ecasound
8
\fBecaconvert\fP \&.extension file1 [ file2 \&.\&.\&. fileN ]
10
\fBecafixdc\fP file1 [ file2 \&.\&.\&. fileN ]
12
\fBecalength\fP file1 [ file2 \&.\&.\&. fileN ]
14
\fBecamonitor\fP [host][:port]
16
\fBecanormalize\fP file1 [ file2 \&.\&.\&. fileN ]
18
\fBecaplay\fP [-dfhklopq] [ file1 file2 \&.\&.\&. fileN ]
20
\fBecasignalview\fP [ options ] [ input ] [ output ]
25
Ecatools are simple command line utils for audio file processing\&.
26
Each tool is designed to perform one specific operation\&. Most of
27
the tools also support batch processing\&.
31
A tool for converting a set of files to a common target format\&.
32
This target format is given as the first command line
33
argument, and its syntax is \fI\&.ext\fP\&.
37
A simple command-line tool for fixing DC-offset\&.
41
See the separate ecalength(1) man page\&.
45
Ecamonitor is a util program that can be used
46
to monitor an active ecasound session\&. Ecamonitor
47
is able to show information about the current
48
chainsetup such as list of inputs, outputs,
49
current position, effects, the engine status
50
and numerous other things\&.
52
By default ecamonitor will try to connect
53
to IP4 address "localhost", to port "2868"\&.
54
A different address can be specified when
55
starting ecamonitor, for example
56
"ecamonitor foo\&.mynetwork\&.com" or
57
"ecamonitor foo\&.mynetwork\&.com:4500"\&.
59
To enable inbound connections, ecasound has to be
60
started with the \fI--daemon\fP option\&. Ecamonitor is
61
implemented in Python using the NetECI API\&.
65
Ecanormalize is a command-line tool for normalizing audio
66
files to utilize the full available sample resolution\&. Ecanormalize
67
first finds out how much the input file can be amplified without
68
clipping and if there is room for increase, a static gain will
69
be applied to the file\&.
73
Ecaplay is a command-line tool for playing audio files\&. Ecaplay
74
uses the libecasound engine and is thus able to handle all audio formats
75
supported by the library\&.
77
Files can be selected for playback either by specifying the
78
filenames on the command-line, or by using the playlist
79
mechanism\&. In playlist mode, files can be added to the playlist
80
using the \fI-q\fP option\&. The \fI-p\fP option can then be used
81
to play all tracks on the playlist\&. Ecaplay will repeat the
82
playlist tracks until explicitly stopped (with double Ctrl-C)\&.
83
Playlist can be flushed with \fI-f\fP and its contents listed
84
with \fI-l\fP option\&.
86
If not otherwise specified, ecaplay will use the audio output device
87
specified in \fI~/\&.ecasound/ecasoundrc\fP for playback\&. A different
88
output device can be selected with \fIECAPLAY_OUTPUT_DEVICE\fP shell
89
environment variable or with the \fI-o:output_device\fP command-line
92
Playback can be stopped at any time with Ctrl-C\&. If multiple
93
files are played, first Ctrl-C will stop the current file and move
94
on to play the next one\&. Issuing Ctrl-C twice (within one second),
95
will cause ecaplay to exit\&.
98
Set libecasound debug level\&. See ecasound(1)\&.
101
Flush the playlist contents\&. See also
102
options \fI-l, -p and -q\fP\&.
105
Print usage information and exit\&.
108
Skip \&'number\&' of files\&.
111
List the current playlist contents to stdout\&. See also
112
options \fI-f, -p and -q\fP\&.
114
.IP "-o:output_device"
115
Use \&'output_device\&' instead of the default output device
116
(as specified in \fI~/\&.ecasound/ecasoundrc\fP)\&. Syntax is same
117
as used by "-o" ecasound option (see ecasound(1) man page)\&.
118
This option overrides the \fIECAPLAY_OUTPUT_DEVICE\fP environment
119
variable (more info below)\&.
122
Play tracks in the playlist (in looped mode)\&. See also
123
options \fI-f, -l and -q\fP\&.
126
Queue new tracks to the playlist\&. All filenames given on
127
the command-line will be added to the the playlist\&. It is
128
possible to queue new tracks while another instance of
129
ecaplay is using the playlist\&. See also options \fI-f, -l
134
Ecasignalview is meant for monitoring signal amplitude and peak
135
statistics\&. It accepts the following options:
138
The first option not starting with a \&'-\&' is interpreted
139
as an input string\&. This can be a device or a filename\&. All formats
140
supported by libecasound are accepted\&. Defaults to \&'/dev/dsp\&'\&.
143
Similarly to input, second option not starting with a \&'-\&'
144
is interpreted as output\&. Defaults to \&'null\&'\&.
147
Buffersize in sample frames\&. Defaults to 128\&.
150
Enable cumulative mode\&. Counters are not reseted after refresh\&.
156
.IP "-f:format_string"
157
Specify default audio format\&. See ecasound(1) for details\&.
160
Specify screen refresh rate in milliseconds\&.
163
Use linear scale for showing audio sample amplitude\&.
166
Use logarithmic scale for showing audio sample amplitude\&.
168
.IP "-G, -B, -M*, -r, -z"
169
Ecasound options use to modify the engine behaviour, see
170
ecasound(1) manpage for details\&.
172
When ecasignalview is running, the following keyboard
173
commands can be used to control the operation (requires
174
system support for UNIX terminal interface control):
177
Reset statistics (max-peak, avg-amplitude and clipped
181
Quit ecasignalview\&.
183
It is also possible to reset the max-peak and clipped-samples
184
counters by sending a SIGHUP signal to the process (i\&.e\&.
185
from another console: "killall -v -HUP ecasignalview")\&.
187
More complete documentation for ecasignalview can be found
188
from "Ecasound User\&'s Guide" (see \&'\&'http://www\&.eca\&.cx/ecasound
189
-> Documentation\&'\&')\&.
195
Path to the ecasound executable\&. Used by many ecatools\&.
197
\fIECAPLAY_OUTPUT_DEVICE\fP
198
Device ecaplay should use for audio output\&. Same syntax
199
as for ecaplay/ecasound "-o" option\&.
204
\fI~/\&.ecasound/ecasoundrc\fP
205
The default ecasound resource file\&. See ecasoundrc(5)
208
\fI~/\&.ecasound/ecaplay_queue\fP
209
File used to store the ecaplay playlist (one track per
210
line with full path)\&.
215
ecasound (1), ecalength(1), "HTML docs in the Documentation subdirectory"
220
Kai Vehmanen, <kvehmanen -at- eca -dot- cx <kvehmanen -at- eca -dot- cx>>