man/sndfile-interleave.1

   1 .Dd November 2, 2014
   2 .Dt SNDFILE-INTERLEAVE 1
   3 .Os
   4 .Sh NAME
   5 .Nm sndfile-interleave ,
   6 .Nm sndfile-deinterleave
   7 .Nd convert mono files into a multi-channel file and vice versa
   8 .Sh SYNOPSIS
   9 .Nm sndfile-interleave
  10 .Ar input1
  11 .Ar input2
  12 .Ar ...
  13 .Fl o Ar output
  14 .Nm sndfile-deinterleave
  15 .Ar file
  16 .Sh DESCRIPTION
  17 .Nm sndfile-interleave
  18 creates a multi-channel file taking audio data
  19 from two or more mono files as individual channels.
  20 The format of the output file is determined by its filename suffix.
  21 The audio parameters of the output file will be made so that
  22 the format can accommodate each of the mono inputs;
  23 for example, the samplerate will be the maximal samplerate
  24 occurring in the inputs.
  25 The output file will be overwritten if it already exists.
  26 .Pp
  27 .Nm sndfile-deinterleave
  28 creates two or more mono files from a multi-channel audio file,
  29 containing data from the individual channels. The names of the
  30 resulting mono files are of the form
  31 .Dq name_XY.suf
  32 where
  33 .Em name
  34 and
  35 .Em suf
  36 are the basename and suffix of the original file.
  37 If any file of such name already exists, it will be overwritten.
  38 Apart from the number of channels,
  39 the audio format of the resulting mono files
  40 is the same as that of the original file.
  41 .Sh EXIT STATUS
  42 .Ex -std
  43 .Sh EXAMPLES
  44 Merge a mono OGG file and a mono FLAC file into a stereo WAV file:
  45 .Bd -literal -offset indent
  46 $ sndfile-interleave left.ogg right.flac -o stereo.wav
  47 .Ed
  48 .Pp
  49 Split a multi-channel into individual mono files:
  50 .Bd -literal -offset indent
  51 $ sndfile-deinterleave multi.wav
  52 Input file : multi
  53 Output files :
  54     multi_00.wav
  55     multi_01.wav
  56     multi_02.wav
  57     multi_03.wav
  58 .Ed
  59 .Sh SEE ALSO
  60 .Lk http://libsndfile.github.io/libsndfile/
  61 .Sh AUTHORS
  62 .An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com