xref: /third_party/libsnd/man/sndfile-interleave.1

.Dd November 2, 2014
.Dt SNDFILE-INTERLEAVE 1
.Os
.Sh NAME
.Nm sndfile-interleave ,
.Nm sndfile-deinterleave
.Nd convert mono files into a multi-channel file and vice versa
.Sh SYNOPSIS
.Nm sndfile-interleave
.Ar input1
.Ar input2
.Ar ...
.Fl o Ar output
.Nm sndfile-deinterleave
.Ar file
.Sh DESCRIPTION
.Nm sndfile-interleave
creates a multi-channel file taking audio data
from two or more mono files as individual channels.
The format of the output file is determined by its filename suffix.
The audio parameters of the output file will be made so that
the format can accommodate each of the mono inputs;
for example, the samplerate will be the maximal samplerate
occurring in the inputs.
The output file will be overwritten if it already exists.
.Pp
.Nm sndfile-deinterleave
creates two or more mono files from a multi-channel audio file,
containing data from the individual channels. The names of the
resulting mono files are of the form
.Dq name_XY.suf
where
.Em name
and
.Em suf
are the basename and suffix of the original file.
If any file of such name already exists, it will be overwritten.
Apart from the number of channels,
the audio format of the resulting mono files
is the same as that of the original file.
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
Merge a mono OGG file and a mono FLAC file into a stereo WAV file:
.Bd -literal -offset indent
$ sndfile-interleave left.ogg right.flac -o stereo.wav
.Ed
.Pp
Split a multi-channel into individual mono files:
.Bd -literal -offset indent
$ sndfile-deinterleave multi.wav
Input file : multi
Output files :
    multi_00.wav
    multi_01.wav
    multi_02.wav
    multi_03.wav
.Ed
.Sh SEE ALSO
.Lk http://libsndfile.github.io/libsndfile/
.Sh AUTHORS
.An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com