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