OGMSPLIT(1)							   User Commands						       OGMSPLIT(1)

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 
 instead of 
.

       -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  renum-
       bered 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  follow-
       ing  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/>

ogmsplit v1.5							   November 2004						       OGMSPLIT(1)