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

FreeBSD Manual Pages

  
 
  

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.
       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  ap-
	      pended 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  in-
	      crease 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 cur-
       rent  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 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/>
       <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.0>

home | help