Provided by: ogmtools_1.5-3ubuntu1_amd64 bug

NAME

       ogmsplit - Split OGG/OGM files into several smaller OGG/OGM files

SYNOPSIS

       ogmsplit [options] inname

DESCRIPTION

       ogmsplit  can  be  used to easily split an OGM file after a given size.  Several OGM files
       will be created that each start with a keyframe.

       inname Use 'inname' as the source.

       -o, --output out
              Use 'out' as the base name. Ascending part numbers will be appended to it.  Default
              is 'inname'. Examples:
              1)  If  -o  output.ogg  is  given  on  the  command  line then ogmsplit will create
              output-000001.ogg, output-000002.ogg and so on.
              2) If no -o option is given and the input's name is movie.ogm  then  ogmsplit  will
              create movie-000001.ogm and so on.

       The operation mode can be set with exactly one of -s, -t, -c or -p. The default mode is to
       split by size (-s).

       -s, --size size
              Size in MiB ( = 1024  *  1024  bytes)  after  which  a  new  file  will  be  opened
              (approximately).  Default  is  700MiB.   Size  can  end  in 'B' to indicate 'bytes'
              instead of 'MiB'.

       -t, --time time
              Split after  the  given  elapsed  time  (approximately).   'time'  takes  the  form
              HH:MM:SS.sss or simply SS(.sss), e.g. 00:05:00.000 or 300.000 or simply 300.

       -c, --cuts cuts
              Produce output files as specified by cuts, a list of slices of the form "start-end"
              or "start+length", separated by commas. If start is omitted, it defaults to the end
              of the previous cut. start and end take the same format as the arguments to -t.

       -n, --num num
              Don't  create  more  than  num  separate files. The last one may be bigger than the
              desired size. Default is an unlimited number of files.  Can only be used with -s or
              -t.

       --frontend
              Frontend mode. Progress output will be terminated by \n instead of \r.

       -p, --print-splitpoints
              Only  print  the key frames and the number of bytes encountered before each. Useful
              to find the exact splitting point.

       -v, --verbose
              Be verbose and show each OGG packet.  Can be used twice to increase verbosity.

       -h, --help
              Show this help.

       -V, --version
              Show version information.

CHAPTER INFORMATION

       ogmsplit correctly  handles  chapter  information.  During  the  first  pass  the  chapter
       information,  if  any  is  present,  will be adjusted to match the output files generated.
       Chapters that are not contained in the current output file are removed entirely. The other
       chapters are renumbered to start at 1, and their timestamps will be recalculated.
       Example: If your source file contains these four chapters:

       CHAPTER01=00:00:00.000
       CHAPTER01NAME=Chapter 01
       CHAPTER02=00:10:00.000
       CHAPTER02NAME=Chapter 02
       CHAPTER03=00:20:00.000
       CHAPTER03NAME=Chapter 03
       CHAPTER04=00:25:00.000
       CHAPTER04NAME=Chapter 04

       and you split after 15 minutes, then the first output file will only contain the first two
       chapters as shown above, and the  second  output  file  will  contain  the  following  two
       chapters and the remaining part of the first:

       CHAPTER01=00:00:00.000
       CHAPTER01NAME=Chapter 02 (continued)
       CHAPTER02=00:05:00.000
       CHAPTER02NAME=Chapter 03
       CHAPTER03=00:10:00.000
       CHAPTER03NAME=Chapter 04

       Note  that  only  variable  names  are  changed,  not  the  chapter names themselves.  The
       exception is the first chapter of the second and following files  where  "(continued)"  is
       appended  in  order to indicate that this is not the start of this chapter. If you want to
       change them as well you'll have to remerge the resulting file with a new chapter file.

AUTHOR

       ogmsplit was written by Moritz Bunkus <moritz@bunkus.org>.

SEE ALSO

       ogmmerge(1), ogminfo(1), ogmdemux(1), ogmcat(1), dvdxchap(1)

WWW

       The newest version can always  be  found  at  <http://www.bunkus.org/videotools/ogmtools/>
       ⟨http://www.bunkus.org/videotools/ogmtools/