Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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.  Sev-
     eral 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 de-
     fault 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 big-
	    ger 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  out-
     put  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  con-
     tain 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 them-
     selves.  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/>

ogmsplit v1.5			  November 2004 		     OGMSPLIT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ogmsplit&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help