PageRenderTime 26ms CodeModel.GetById 15ms app.highlight 4ms RepoModel.GetById 1ms app.codeStats 1ms

/man/1/flvmeta.1

https://code.google.com/
Unknown | 189 lines | 184 code | 5 blank | 0 comment | 0 complexity | 7d29f3382e6c3e9aeddfe86df033a6ae MD5 | raw file
  1.\" generated with Ronn/v0.7.3
  2.\" http://github.com/rtomayko/ronn/tree/0.7.3
  3.
  4.TH "FLVMETA" "1" "September 2011" "" ""
  5.
  6.SH "NAME"
  7\fBflvmeta\fR \- manipulate or extract metadata in Adobe Flash Video Files
  8.
  9.SH "SYNOPSIS"
 10\fBflvmeta\fR \fIINPUT_FILE\fR
 11.
 12.br
 13\fBflvmeta\fR \fIINPUT_FILE\fR \fIOUTPUT_FILE\fR
 14.
 15.br
 16\fBflvmeta\fR \fB\-D\fR|\fB\-\-dump\fR [\fIoptions\fR] \fIINPUT_FILE\fR
 17.
 18.br
 19\fBflvmeta\fR \fB\-F\fR|\fB\-\-full\-dump\fR [\fIoptions\fR] \fIINPUT_FILE\fR
 20.
 21.br
 22\fBflvmeta\fR \fB\-C\fR|\fB\-\-check\fR [\fIoptions\fR] \fIINPUT_FILE\fR
 23.
 24.br
 25\fBflvmeta\fR \fB\-U\fR|\fB\-\-update\fR [\fIoptions\fR] \fIINPUT_FILE\fR [\fIOUTPUT_FILE\fR]
 26.
 27.SH "DESCRIPTION"
 28\fBflvmeta\fR is a command\-line utility aimed at manipulating Adobe(tm) Flash Video Files (FLV), through several commands, only one of which can be used for each invocation of the program\.
 29.
 30.P
 31It possesses the ability to compute and inject a variety of values in the \fIonMetaData\fR event tag, including keyframe indices used by most video players to allow random\-access seeking, notably for HTTP pseudo\-streamed files via a server\-side module, by having the client send the file offset looked up for the nearest desired keyframe\. Tools such as \fBflvmeta\fR must be used in the case the initial encoding process is unable to inject those metadata\.
 32.
 33.P
 34It can also optionnally inject the \fIonLastSecond\fR event, used to signal the end of playback, used for example to revert the player software to a \'stopped\' state\.
 35.
 36.P
 37\fBflvmeta\fR also has the ability to dump metadata and full file information to standard output, in a variety of textual output formats, including XML, YAML, and JSON\.
 38.
 39.P
 40Finally, the program can analyze FLV files to detect potential problems and errors, and generate a textual report in a raw format, or in XML\. It has the ability to detect more than a hundred problems, going from harmless to potentially unplayable, using a few real world encountered issues\. This analysis can also determine and display the minimal Flash Player version which can be used to correctly play a given file, as well as codec information\.
 41.
 42.P
 43\fBflvmeta\fR can operate on arbitrarily large files, and can handle FLV files using extended (32\-bit) timestamps\. It can guess video frame dimensions for all known video codecs supported by the official FLV specification\.
 44.
 45.P
 46Its memory usage remains minimal, as it uses a two\-pass reading algorithm which permits the computation of all necessary tags without loading anything more than the file\'s tags headers in memory\. Only the dumping of JSON data can consume more memory, since the bundled \fBmjson\fR library constructs a data tree in memory before outputting the formatted data\.
 47.
 48.SH "COMMANDS"
 49Only one command can be specified for an invocation of \fBflvmeta\fR\. The chosen command determines the mode of execution of the program\.
 50.
 51.P
 52By default, if no command is specified, \fBflvmeta\fR will implicitely choose the command to use according to the presence of \fIINPUT_FILE\fR and \fIOUTPUT_FILE\fR\.
 53.
 54.P
 55If only \fIINPUT_FILE\fR is present, the \fB\-D\fR|\fB\-\-dump\fR command will be executed\.
 56.
 57.P
 58If both \fIINPUT_FILE\fR and \fIOUTPUT_FILE\fR are present, the \fB\-U\fR|\fB\-\-update\fR command will be executed\.
 59.
 60.IP "\(bu" 4
 61\fB\-D\fR, \fB\-\-dump\fR: Dump a textual representation of the first \fIonMetaData\fR tag found in \fIINPUT_FILE\fR to standard output\. The default format is XML, unless specified otherwise\.
 62.
 63.IP
 64It is also possible to specify another event via the \fB\-e\fR option, such as \fIonLastSecond\fR\.
 65.
 66.IP "\(bu" 4
 67\fB\-F\fR, \fB\-\-full\-dump\fR: Dump a textual representation of the whole contents of \fIINPUT_FILE\fR to standard output\. The default format is XML, unless specified otherwise\.
 68.
 69.IP "\(bu" 4
 70\fB\-C\fR, \fB\-\-check\fR: Print a report to standard output listing warnings and errors detected in \fIINPUT_FILE\fR, as well as potential incompatibilities, and informations about the codecs used in the file\. The exit code will be set to a non\-zero value if there is at least one error in the file\.
 71.
 72.IP
 73The output format can either be plain text or XML using the \fB\-\-xml\fR option\. It can also be disabled altogether using the \fB\-\-quiet\fR option if you are only interested in the exit status\.
 74.
 75.IP
 76Messages are divided into four specific levels of increasing importance:
 77.
 78.IP "\(bu" 4
 79\fIinfo\fR: informational messages that do not pertain to the file validity
 80.
 81.IP "\(bu" 4
 82\fIwarning\fR: messages that inform of oddities to the flv format but that might not hamper file reading or playability, this is the default level
 83.
 84.IP "\(bu" 4
 85\fIerror\fR: messages that inform of errors that might render the file impossible to play or stream correctly
 86.
 87.IP "\(bu" 4
 88\fIfatal\fR: messages that inform of errors that make further file reading impossible therefore ending parsing completely
 89.
 90.IP "" 0
 91.
 92.IP
 93Each message or message template presented to the user is identified by a specific code of the following format:
 94.
 95.IP
 96\fB[level][topic][id]\fR
 97.
 98.IP "\(bu" 4
 99\fIlevel\fR is an upper\-case letter that can be either I, W, E, F according to the aforementioned message levels
100.
101.IP "\(bu" 4
102\fItopic\fR is a two\-digit integer representing the general topic of the message
103.
104.IP "\(bu" 4
105\fIid\fR is a unique three\-digit identifier for the message, or message template if parameterized
106.
107.IP "" 0
108.
109.IP
110Messages can be related to the following topics :
111.
112.IP "\(bu" 4
113.
114.IP "\(bu" 4
115\fI11\fR file header
116.
117.IP "\(bu" 4
118\fI12\fR previous tag size
119.
120.IP "" 0
121
122.
123.IP "\(bu" 4
124\fI20\fR tag format
125.
126.IP "\(bu" 4
127\fI30\fR tag types
128.
129.IP "\(bu" 4
130\fI40\fR timestamps
131.
132.IP "\(bu" 4
133.
134.IP "\(bu" 4
135\fI51\fR audio codecs
136.
137.IP "" 0
138
139.
140.IP "\(bu" 4
141.
142.IP "\(bu" 4
143\fI61\fR video codecs
144.
145.IP "" 0
146
147.
148.IP "\(bu" 4
149\fI70\fR metadata
150.
151.IP "\(bu" 4
152.
153.IP "\(bu" 4
154\fI81\fR keyframes
155.
156.IP "\(bu" 4
157\fI82\fR cue points
158.
159.IP "" 0
160
161.
162.IP "" 0
163.
164.IP
165For example, \fIW10050\fR represents a Warning in topic 10 with the id 050\.
166.
167.IP "" 0
168.
169.SH "OPTIONS"
170.
171.SS "DUMP"
172.
173.SS "FULL DUMP"
174.
175.SH "FORMATS"
176.
177.SH "EXAMPLES"
178.
179.SH "EXIT STATUS"
180.
181.SH "BUGS"
182\fBflvmeta\fR does not support encrypted FLV files yet\.
183.
184.SH "AUTHOR"
185.
186.SH "COPYRIGHT"
187.
188.SH "CONTACT"
189