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.