kateenc


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




libkate 0.4.1                   13 october 2010                     KATEENC(1)