<insert file="../es-makrot.txt" /> <insert name="ecasound_indexbar" /> <p> <hr> <center><h2> ecasound documentation - manual pages </h2></center> </p> <html><head><title>ecatools</title> <link rev="made" href="mailto:kai.vehmanen@wakkanet.fi"> </head> <body> <hr> <h1>ecatools</h1> <h2>06.11.2002</h2> <p><h2>NAME</h2> ecatools - audio processing utils based on ecasound <p><h2>SYNOPSIS</h2> <strong>ecaconvert</strong> .extension file1 [ file2,...,fileN ] <p><strong>ecafixdc</strong> file1 [ file2,...,fileN ] <p><strong>ecalength</strong> file1 [ file2,...,fileN ] <p><strong>ecamonitor</strong> [host][:port] <p><strong>ecanormalize</strong> file1 [ file2,...,fileN ] <p><strong>ecaplay</strong> [-dhk] file1 [ file2,...,fileN ] <p><strong>ecasignalview</strong> [ options ] [ input ] [ output ] <p><h2>DESCRIPTION</h2> <p>Ecatools are simple command line utils that do various audio processing tasks. Most of them support batch processing. They all use ecasound to do the actual audio processing work. <p><strong>ECACONVERT</strong> <p>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 <em>.ext</em>. <p><strong>ECAFIXDC</strong> <p>A simple command-line tool for fixing DC-offset. <p><strong>ECALENGTH</strong> <p>See the separate ecalength(1) man page. <p><strong>ECAMONITOR</strong> <p>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. <p>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". <p>To enable inbound connections, ecasound has to be started with the <em>--daemon</em> option. Ecamonitor is implemented in Python using the NetECI API. <p><strong>ECANORMALIZE</strong> <p>A simple command-line tool for normalizing sample volume. Finds out how much input file can be amplified without clipping and, if necessary, does the amplification. <p><strong>ECAPLAY</strong> <p>Command-line tool that plays input files using the default output specified in <em>~/.ecasoundrc</em>. Note! You can abort ecaplay at any time by pressing Ctrl-C. If you are playing multiple files, this will stop the current file and begin playing the next one. If you want to abort playing immediately instead of skipping to the next file, press Ctrl-C twice in short succession (around one second). <p><dl> <p></p><dt><strong>-d:debuglevel</strong><dd> Set libecasound debug level. See ecasound(1). <p><p></p><dt><strong>-h</strong><dd> Print usage information and exit. <p><p></p><dt><strong>-k:number</strong><dd> Skip 'number' of files. <p><p></p><dt><strong>-o:output_device</strong><dd> Use 'output_device' instead of the default output device (as specified in <em>~/.ecasoundrc</em>. <p></dl> <p><strong>ECASIGNALVIEW</strong> <p>Ecasignalview is meant for monitoring signal amplitude and peak statistics. It accepts the following options: <p><dl> <p></p><dt><strong>input</strong><dd> The first option not starting with a '-' is interpreted as input string. This can be a device or a filename. All formats supported by libecasound are accepted. Defaults to '/dev/dsp'. <p><p></p><dt><strong>output</strong><dd> Similarly to input, second option not starting with a '-' is interpreted as output. Defaults to 'null'. <p><p></p><dt><strong>-b:buffersize</strong><dd> Buffersize in sample frames. Defaults to 128. <p><p></p><dt><strong>-c</strong><dd> Enable cumulative mode. Counters are not reseted after refresh. <em>*deprecated*</em> <p><p></p><dt><strong>-d</strong><dd> Enable debug mode. <p><p></p><dt><strong>-f:format_string</strong><dd> Specify default audio format. See ecasound(1) for details. <p><p></p><dt><strong>-r:rate_msec</strong><dd> Specify screen refresh rate in milliseconds. </dl> <p>More complete documentation for ecasignalview can be found from "Ecasound User's Guide" (see ''http://www.eca.cx/ecasound -> Documentation''). <p><h2>ENVIRONMENT</h2> <p><em>ECASOUND</em> Path to the ecasound executable. Affects most ecatools. <p><h2>FILES</h2> <p><em>~/.ecasound/ecasoundrc</em> The default ecasound resource file. See ecasoundrc(5) for details. <p><h2>SEE ALSO</h2> <p>ecasound (1), ecalength(1), "HTML docs in the Documentation subdirectory" <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>