[QUESTION] Is the ttxt format specification documented anywhere? #593

New Issue

claunia · 2026-01-29T16:48:40Z

claunia commented

2026-01-29 16:48:40 +00:00

Originally created by @slifty on GitHub (Jun 29, 2020).

CCExtractor version: 0.88

Necessary information

N/A

Additional information

I'm writing a parser for ccextractor output as part of a video processing pipeline project, and was wondering if there is a specification for the ttxt otput format. I know there are other formats linked to pretty robust specs (e.g. smptett) but the ttxt seems very concise so I would prefer to stick with that.

I couldn't find anything obvious in the documentation, but I could easily have missed something!

Originally created by @slifty on GitHub (Jun 29, 2020). CCExtractor version: 0.88 # Necessary information N/A # Additional information I'm writing a parser for ccextractor output as part of [a video processing pipeline project](https://tv.kitchen), and was wondering if there is a specification for the `ttxt` otput format. I know there are other formats linked to pretty robust specs (e.g. `smptett`) but the `ttxt` seems very concise so I would prefer to stick with that. I couldn't find anything obvious in the documentation, but I could easily have missed something!

claunia closed this issue

2026-01-29 16:48:40 +00:00

claunia commented

2026-01-29 16:48:41 +00:00

@NilsIrl commented on GitHub (Jun 30, 2020):

From --help:

Transcript customizing options:
    -customtxt format: Use the passed format to customize the (Timed) Transcript
                       output. The format must be like this: 1100100 (7 digits).
                       These indicate whether the next things should be
                       displayed or not in the (timed) transcript. They
                       represent (in order): 
                           - Display start time
                           - Display end time
                           - Display caption mode
                           - Display caption channel
                           - Use a relative timestamp ( relative to the sample)
                           - Display XDS info
                           - Use colors
                       Examples:
                       0000101 is the default setting for transcripts
                       1110101 is the default for timed transcripts
                       1111001 is the default setting for -ucla
                       Make sure you use this parameter after others that might
                       affect these settings (-out, -ucla, -xds, -txt, 
                       -ttxt ...)

@NilsIrl commented on GitHub (Jun 30, 2020): From `--help`: ``` Transcript customizing options: -customtxt format: Use the passed format to customize the (Timed) Transcript output. The format must be like this: 1100100 (7 digits). These indicate whether the next things should be displayed or not in the (timed) transcript. They represent (in order): - Display start time - Display end time - Display caption mode - Display caption channel - Use a relative timestamp ( relative to the sample) - Display XDS info - Use colors Examples: 0000101 is the default setting for transcripts 1110101 is the default for timed transcripts 1111001 is the default setting for -ucla Make sure you use this parameter after others that might affect these settings (-out, -ucla, -xds, -txt, -ttxt ...) ```

claunia commented

2026-01-29 16:48:41 +00:00

@NilsIrl commented on GitHub (Jun 30, 2020):

Also just to make it clear, ttxt isn't a formally specified format, unlike many of the formats supported by ccextractor. So you may prefer to use one of those instead.

@NilsIrl commented on GitHub (Jun 30, 2020): Also just to make it clear, `ttxt` isn't a formally specified format, unlike many of the formats supported by `ccextractor`. So you may prefer to use one of those instead.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/ccextractor#593