cannam@125: .Dd November 2, 2014
cannam@125: .Dt SNDFILE-CONVERT 1
cannam@125: .Os
cannam@125: .Sh NAME
cannam@125: .Nm sndfile-convert
cannam@125: .Nd convert sound files from one format to another
cannam@125: .Sh SYNOPSIS
cannam@125: .Nm sndfile-convert
cannam@125: .Op Fl override-sample-rate Ns = Ns Ar rate
cannam@125: .Op Fl endian Ns = Ns Cm little | big | cpu
cannam@125: .Op Fl normalize
cannam@125: .Op Ar encoding
cannam@125: .Ar input
cannam@125: .Ar output
cannam@125: .Sh DESCRIPTION
cannam@125: .Nm
cannam@125: converts sound files from one audio format to another.
cannam@125: The output file is overwritten it it already exists.
cannam@125: .Ss Formats
cannam@125: The format of the output file is determined by the filename extension.
cannam@125: The following file formats are currently recognized:
cannam@125: .Pp
cannam@125: .Bl -tag -compact -width ircam
cannam@125: .It wav
cannam@125: WAV (Microsoft)
cannam@125: .It aif
cannam@125: AIFF (Apple/SGI)
cannam@125: .It au
cannam@125: AU (Sun/NeXT)
cannam@125: .It snd
cannam@125: AU (Sun/NeXT)
cannam@125: .It raw
cannam@125: RAW (header-less)
cannam@125: .It gsm
cannam@125: RAW (header-less)
cannam@125: .It vox
cannam@125: RAW (header-less)
cannam@125: .It paf
cannam@125: PAF (Ensoniq PARIS, big-endian)
cannam@125: .It fap
cannam@125: PAF (Ensoniq PARIS, little-endian)
cannam@125: .It svx
cannam@125: IFF (Amiga IFF/SVX8/SV16)
cannam@125: .It nist
cannam@125: SPHERE (NIST SPeech HEader Resources)
cannam@125: .It sph
cannam@125: SPHERE (NIST SPeech HEader Resources)
cannam@125: .It voc
cannam@125: VOC (Creative Labs)
cannam@125: .It ircam
cannam@125: SF (Berkeley/IRCAM/CARL)
cannam@125: .It sf
cannam@125: SF (Berkeley/IRCAM/CARL)
cannam@125: .It w64
cannam@125: W64 (SoundFoundry WAVE 64)
cannam@125: .It mat
cannam@125: MAT4 (GNU Octave 2.0 / Matlab 4.2)
cannam@125: .It mat4
cannam@125: MAT4 (GNU Octave 2.0 / Matlab 4.2)
cannam@125: .It mat5
cannam@125: MAT5 (GNU Octave 2.1 / Matlab 5.0)
cannam@125: .It pvf
cannam@125: PVF (Portable Voice Format)
cannam@125: .It xi
cannam@125: XI (FastTracker 2)
cannam@125: .It htk
cannam@125: HTK (HMM Tool Kit)
cannam@125: .It sds
cannam@125: SDS (Midi Sample Dump Standard)
cannam@125: .It avr
cannam@125: AVR (Audio Visual Research)
cannam@125: .It wavex
cannam@125: WAVEX (MS WAVE with WAVEFORMATEX)
cannam@125: .It sd2
cannam@125: SD2 (Sound Designer II)
cannam@125: .It flac
cannam@125: FLAC (FLAC Lossless Audio Codec)
cannam@125: .It caf
cannam@125: CAF (Apple Core Audio File)
cannam@125: .It wve
cannam@125: WVE (Psion Series 3)
cannam@125: .It prc
cannam@125: WVE (Psion Series 3)
cannam@125: .It ogg
cannam@125: OGG (OGG Container format)
cannam@125: .It oga
cannam@125: OGG (OGG Container format)
cannam@125: .It mpc
cannam@125: MPC (Akai MPC 2k)
cannam@125: .It rf64
cannam@125: RF64 (RIFF 64)
cannam@125: .El
cannam@125: .Ss Options
cannam@125: The following options are recoginzed:
cannam@125: .Pp
cannam@125: .Bl -tag -compact -width "override-sample-rate=XXXXX"
cannam@125: .It Fl override-sample-rate Ns = Ns Ar rate
cannam@125: Make the input use sample rate of
cannam@125: .Ar rate
cannam@125: Hz.
cannam@125: .It Fl endian Ns = Ns Cm little
cannam@125: Make the output file use little endian data.
cannam@125: .It Fl endian Ns = Ns Cm big
cannam@125: Make the output file use big endian data.
cannam@125: .It Fl endian Ns = Ns Cm cpu
cannam@125: Make the output file use CPU endianness.
cannam@125: .It Fl normalize
cannam@125: Normalize the audio data in the output file.
cannam@125: .El
cannam@125: .Ss Encodings
cannam@125: The optional
cannam@125: .Ar encoding
cannam@125: parameter allows setting of the data encoding for the output file.
cannam@125: The following encodings are currently supported:
cannam@125: .Pp
cannam@125: .Bl -tag -compact -width ima-adpcmXX
cannam@125: .It Fl pcms8
cannam@125: signed 8 bit pcm
cannam@125: .It Fl pcmu8
cannam@125: unsigned 8 bit pcm
cannam@125: .It Fl pcm16
cannam@125: 16 bit pcm
cannam@125: .It Fl pcm24
cannam@125: 24 bit pcm
cannam@125: .It Fl pcm32
cannam@125: 32 bit pcm
cannam@125: .It Fl float32
cannam@125: 32 bit floating point
cannam@125: .It Fl ulaw
cannam@125: ULAW
cannam@125: .It Fl alaw
cannam@125: ALAW
cannam@125: .It Fl ima-adpcm
cannam@125: IMA ADPCM (WAV only)
cannam@125: .It Fl ms-adpcm
cannam@125: MS ADPCM (WAV only)
cannam@125: .It Fl gsm610
cannam@125: GSM6.10 (WAV only)
cannam@125: .It Fl dwvw12
cannam@125: 12 bit DWVW (AIFF only)
cannam@125: .It Fl dwvw16
cannam@125: 16 bit DWVW (AIFF only)
cannam@125: .It Fl dwvw24
cannam@125: 24 bit DWVW (AIFF only)
cannam@125: .It Fl vorbis
cannam@125: Vorbis (OGG only)
cannam@125: .El
cannam@125: .Pp
cannam@125: If no encoding is specified for the output file,
cannam@125: .Nm
cannam@125: will try to use the encoding of the input file.
cannam@125: This will not always work as most container formats
cannam@125: (e.g. WAV, AIFF etc) only support a small subset of encodings
cannam@125: (e.g. 16 bit PCM, a-law, Vorbis etc).
cannam@125: .Sh EXIT STATUS
cannam@125: .Ex -std
cannam@125: .Sh SEE ALSO
cannam@125: .Lk http://www.mega-nerd.com/libsndfile/
cannam@125: .Sh AUTHORS
cannam@125: .An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com .