KATEENC(1)							      libkate								KATEENC(1)

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 emit-
	      ted 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)

libkate 0.4.1							  13 october 2010							KATEENC(1)