Manpages

NAME

kateenc − create Kate streams from text input

SYNOPSIS

kateenc [−hVM] [−o outfile] [−l language] [−c category] [−s serial] [−C tag=value] [−R threshold] [−K threshold] −t filetype [ infile ]

DESCRIPTION

kateenc creates Kate streams from input files (SubRip SRT subtitles, LRC lyrics, and libkate’s custom description language). When saved to an Ogg stream (the default behavior), a Kate stream may then be merged with other Ogg streams (eg, a Theora video) using the oggz tools.

OPTIONS

−h

Show command line help.

−V

Show version information.

−M

Allow simple HTML-like markup in SRT files. If this parameter is used, strings such as "<i>" will be interpreted to mean italics, rather than appear as such. Note that various players interpret a slightly different set of HTML tags, and some do not.

−o outfile

Write the output Kate stream to the given file name (writes to stdout if not specified).

−l language

Sets the language for the stream (default is the language specified in the input, or none).

−c category

Sets the category for the stream (default is the category specified in the input, or none).

−s serial

Sets the serial number for the output Kate stream (does not apply to raw streams).

−C tag=value

Adds a comment to encode into the output Kate stream. The comment must be of the form tag=value, and comply with the Vorbis comment rules (eg, tag is composed of a particular subset of ASCII characters, and value is valid UTF-8). Note that you might have to escape or quote the comment for it to be seen as a single command line parameter.

−t filetype

Specifies the type of the input (srt, lrc, kate)

−R threshold

Use repeat packets, with the given threshold (in seconds). Data packets will be repeated at intervals of roughly threshold seconds, while active.

−K threshold

Use keepalive packets, with the given threshold (in seconds). Keepalive packets will be emitted when no other packet has been emitted for roughly threshold seconds.

EXAMPLES

Create a Kate stream for Welsh subtitles from a SubRip file:

kateenc −t srt −l cy −c SUB −o output.ogg input.srt

SEE ALSO

katedec(1), katalyzer(1)