|
Packit |
a38265 |
.TH "oggz-merge" "1"
|
|
Packit |
a38265 |
.SH "NAME"
|
|
Packit |
a38265 |
oggz-merge \(em Merge Ogg files together, interleaving pages in order of
|
|
Packit |
a38265 |
presentation time.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "SYNOPSIS"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-merge\fR [\-o \fBfilename\fR | \-\-output \fBfilename\fR ] filename \&...
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-merge\fR [\-h | \-\-help ] [\-v | \-\-version ]
|
|
Packit |
a38265 |
.SH "Description"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-merge\fR merges Ogg files together, interleaving
|
|
Packit |
a38265 |
pages in order of presentation time.
|
|
Packit |
a38265 |
It correctly interprets the granulepos timestamps of
|
|
Packit |
a38265 |
Ogg CELT, CMML, Dirac, FLAC, Kate, PCM, Speex, Theora and Vorbis
|
|
Packit |
a38265 |
bitstreams.
|
|
Packit |
a38265 |
Run \fBoggz-known-codecs\fP\fB(1)\fP for a full list
|
|
Packit |
a38265 |
of codecs known by the installed version of oggz.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
For example, if you have an Ogg Theora video file, and its soundtrack
|
|
Packit |
a38265 |
stored separately as an Ogg Speex audio file, and you can use
|
|
Packit |
a38265 |
\fBoggz-merge\fR to create a single Ogg file containing
|
|
Packit |
a38265 |
the video and audio, interleaved together in parallel.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Similarly, using \fBoggz-merge\fR on a collection of Ogg
|
|
Packit |
a38265 |
Vorbis audio files will create a big Ogg file with all the songs in
|
|
Packit |
a38265 |
parallel, ie. interleaved for simultaneous playback. Such a file is
|
|
Packit |
a38265 |
proper Ogg, but not "Ogg Vorbis I" \-\- the Ogg Vorbis I specification
|
|
Packit |
a38265 |
defines an Ogg Vorbis file as an Ogg file containing only one Vorbis
|
|
Packit |
a38265 |
track at a time (ie. no parallel multiplexing). Many music players
|
|
Packit |
a38265 |
(which use libvorbisfile) aren't designed to play multitrack Ogg files.
|
|
Packit |
a38265 |
In general however, video players, and anything built on a multimedia
|
|
Packit |
a38265 |
framework (like GStreamer, DirectShow etc.) will probably be able to
|
|
Packit |
a38265 |
handle such files.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
If you want to create a file containing some Ogg files sequenced one
|
|
Packit |
a38265 |
after another, then you should simply concatenate them together using
|
|
Packit |
a38265 |
\fBcat\fR. In Ogg this is called "chaining". If you cat
|
|
Packit |
a38265 |
Ogg Vorbis I audio files together, then the result will also be a
|
|
Packit |
a38265 |
compliant Ogg Vorbis file.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "Options"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-merge\fR accepts the following options:
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SS "Miscellaneous options"
|
|
Packit |
a38265 |
.IP "\-o \fBfilename\fR, \-\-output \fBfilename\fR" 10
|
|
Packit |
a38265 |
Write output to the specified
|
|
Packit |
a38265 |
\fBfilename\fR instead of printing it to
|
|
Packit |
a38265 |
standard output.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.IP "\-h, \-\-help" 10
|
|
Packit |
a38265 |
Display usage information and exit.
|
|
Packit |
a38265 |
.IP "\-v, \-\-version" 10
|
|
Packit |
a38265 |
Output version information and exit.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH EXAMPLES
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Merge pages of audio.oga and video.ogv:
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
.RS
|
|
Packit |
a38265 |
\f(CWoggz merge \-o output.ogv audio.oga video.ogv\fP
|
|
Packit |
a38265 |
.RE
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "AUTHOR"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Conrad Parker September 21, 2004;
|
|
Packit |
a38265 |
.SH "COPYRIGHT"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Copyright \(co 2004 CSIRO Australia
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "SEE ALSO"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBcat\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBoggz-rip\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBoggz-dump\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBoggz-diff\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBhogg\fP\fB(1)\fP
|
|
Packit |
a38265 |
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35
|