DragonFly On-Line Manual Pages

audiotool(1)                          OST                         audiotool(1)

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 (C) 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.

GNU ccAudio Tool                 October 2004                     audiotool(1)