NAME

       audiotool - manipulate audio data files.

SYNOPSIS

       audiotool -append [-offset=pos] target audiofiles...
       audiotool -build [-encoding=codec] target audiofiles...
       audiotool -chart [-silence=value] [-framing=msec] audiofiles...
       audiotool -codecs
       audiotool -info audiofile
       audiotool -notation audiofile [``new-string'']
       audiotool -play audiofiles...
       audiotool -plugins
       audiotool -soundcard [index]
       audiotool -strip [-silence=value] [-framing=msec] audiofiles...
       audiotool -trim [-silence=value] [-framing=msec] [-padding=frames] audiofiles...
       audiotool -version

DESCRIPTION

       Audiotool  is  used  to  copy, manipulate, and examine the contents of audio files.  These
       audio files may be raw headerless audio data or audio stored in common data files such  as
       .wav  or .au files.  In the near future audiotool will also support packetized audio files
       such as .mp3 and .ogg.

       -append
              appends the content of other audio files into an existing audio file.   The  offset
              to save within the existing file may be specified.  If nessisary the content of the
              specified files will be re-encoded in the codec of the file being appended to.

       -build Build a brand new audio file from scratch and then copy content from existing audio
              files into it.  The encoding of the new audio file will either be based on the file
              extension, the audio file that is being  copied  into  it,  or  by  specifying  the
              encoding format directly.

       -chart This  is used to generate an energy chart profile of the audio file frame by frame.
              A * indicates solid audio content, a ^ indicates what might be a  lead  or  trailer
              section  of  partial  content, and a . indicates relative silence.  Soon a autotrim
              option will be added to audiotool to remove silent frames.

       -codecs
              List all active codec objects.  If you have plugins which are loaded  that  creates
              codec objects which match a built-in codec, the plugin will be selected first.

       -info  The  info  command  gives  you  basic information on the audio file, including what
              format it is stored as, what codec the audio data is encoded in, how much  data  is
              in the file, what the bit rate used is, etc.

       -notation
              Notation  can be used to either set or display the annotation stored in audio files
              which support annotations, such as .au and .wav files.

       -play  Plays the content of the audio file to the default system audio device (soundcard).
              Play  is  supported  on  w32 and posix systems that support oss audio.  Future work
              will expand to additional platforms.

       -plugins
              This simply returns the path to the plugins directory.  All plugins are loaded with
              Audio::init().  Plugins are not supported when building with static linkage.

       -strip Strips  out  all  silent  frames from an audio file.  Silent frames are those which
              fall below a threashold and that have no peak impulse above the threashold.

       -trim  Removes leading and trailing "silence" from a file.  The  -padding  option  may  be
              used  to  add  additional  silent  frames  at the end of the file after it has been
              trimed, as this may be needed for files that will later be used  to  join  together
              phrases.

BUGS

       At  this  time  audiotool  does  not  perform  and  ccaudio  does  not support sample rate
       conversion.  Appending and building from files which are encoded at different sample rates
       could have ammusing results.

AUTHOR

       Written by David Sugar.

REPORTING BUGS

       Report bugs to <dyfet@gnu.org>.

COPYRIGHT

       Copyright © 2004 Open Source Telecom Corp.
       This  is  free software; see the source for copying conditions.  There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.