Man Linux: Main Page and Category List

NAME

       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.

       ECAFIXDC

       A simple command-line tool for fixing DC-offset.

       ECALENGTH

       See the separate ecalength(1) man page.

       ECAMONITOR

       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.

       -d:debuglevel
              Set libecasound debug level. See ecasound(1).

       -f     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.

       -I     Use linear scale for showing audio sample amplitude.

       -L     Use logarithmic scale for showing audio sample amplitude.

       -G, -B, -M*, -r, -z
              Ecasound  options  use  to  modify  the  engine  behaviour,  see
              ecasound(1) manpage for details.

              When ecasignalview is running, the following  keyboard  commands
              can  be  used  to control the operation (requires system support
              for UNIX terminal interface control):

       spacebar
              Reset statistics (max-peak, avg-amplitude  and  clipped  samples
              count).

       q or Q or Esc
              Quit ecasignalview.

              It  is  also  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).

SEE ALSO

       ecasound  (1),  ecalength(1),   "HTML   docs   in   the   Documentation
       subdirectory"

AUTHOR

       Kai  Vehmanen,  <kvehmanen  -at- eca -dot- cx <kvehmanen -at- eca -dot-
       cx>>

                                  12.11.2005                       ecatools(1)