1OGMSPLIT(1) User Commands OGMSPLIT(1)
2
6 ogmsplit - Split OGG/OGM files into sevaral smaller OGG/OGM files
7
9 ogmsplit [options] inname
10
12 ogmsplit can be used to easily split an OGM file after a given size.
13 Several OGM files will be created that each start with a keyframe.
14 inname Use 'inname' as the source.
16 -o, --output out
18 Use 'out' as the base name. Ascending part numbers will be
19 appended to it. Default is 'inname'. Examples:
20 1) If -o output.ogg is given on the command line then ogmsplit
21 will create output-000001.ogg, output-000002.ogg and so on.
22 2) If no -o option is given and the input's name is movie.ogm
23 then ogmsplit will create movie-000001.ogm and so on.
24 The operation mode can be set with exactly one of -s, -t, -c or -p. The
26 default mode is to split by size (-s).
27 -s, --size size
29 Size in MiB ( = 1024 * 1024 bytes) after which a new file will
30 be opened (approximately). Default is 700MiB. Size can end in
31 'B' to indicate 'bytes' instead of 'MiB'.
32 -t, --time time
34 Split after the given elapsed time (approximately). 'time'
35 takes the form HH:MM:SS.sss or simply SS(.sss), e.g.
36 00:05:00.000 or 300.000 or simply 300.
37 -c, --cuts cuts
39 Produce output files as specified by cuts, a list of slices of
40 the form "start-end" or "start+length", separated by commas. If
41 start is omitted, it defaults to the end of the previous cut.
42 start and end take the same format as the arguments to -t.
43 -n, --num num
45 Don't create more than num separate files. The last one may be
46 bigger than the desired size. Default is an unlimited number of
47 files. Can only be used with -s or -t.
48 --frontend
50 Frontend mode. Progress output will be terminated by \n instead
51 of \r.
52 -p, --print-splitpoints
54 Only print the key frames and the number of bytes encountered
55 before each. Useful to find the exact splitting point.
56 -v, --verbose
58 Be verbose and show each OGG packet. Can be used twice to
59 increase verbosity.
60 -h, --help
62 Show this help.
63 -V, --version
65 Show version information.
66
68 ogmsplit correctly handles chapter information. During the first pass
69 the chapter information, if any is present, will be adjusted to match
70 the output files generated. Chapters that are not contained in the cur‐
71 rent output file are removed entirely. The other chapters are renum‐
72 bered to start at 1, and their timestamps will be recalculated.
73 Example: If your source file contains these four chapters:
74 CHAPTER01=00:00:00.000
76 CHAPTER01NAME=Chapter 01
77 CHAPTER02=00:10:00.000
78 CHAPTER02NAME=Chapter 02
79 CHAPTER03=00:20:00.000
80 CHAPTER03NAME=Chapter 03
81 CHAPTER04=00:25:00.000
82 CHAPTER04NAME=Chapter 04
83 and you split after 15 minutes, then the first output file will only
85 contain the first two chapters as shown above, and the second output
86 file will contain the following two chapters and the remaining part of
87 the first:
88 CHAPTER01=00:00:00.000
90 CHAPTER01NAME=Chapter 02 (continued)
91 CHAPTER02=00:05:00.000
92 CHAPTER02NAME=Chapter 03
93 CHAPTER03=00:10:00.000
94 CHAPTER03NAME=Chapter 04
95 Note that only variable names are changed, not the chapter names them‐
97 selves. The exception is the first chapter of the second and following
98 files where "(continued)" is appended in order to indicate that this is
99 not the start of this chapter. If you want to change them as well
100 you'll have to remerge the resulting file with a new chapter file.
101
103 ogmsplit was written by Moritz Bunkus <moritz@bunkus.org>.
104
106 ogmmerge(1), ogminfo(1), ogmdemux(1), ogmcat(1), dvdxchap(1)
107
109 The newest version can always be found at
110 <http://www.bunkus.org/videotools/ogmtools/>
111 ⟨http://www.bunkus.org/videotools/ogmtools/⟩
112ogmsplit v1.5 November 2004 OGMSPLIT(1)