Skip to main content

Print_timecode

NameTypeDescription
xinteger
string
The x location to start the imprint. Can use expressions such as w-20 (w: width of the video).
default: 25
yinteger
string
The y location to start the imprint. Can use expressions such as h-20 (h: height of the video).
default: 25
fontstringThe font descriptor (compliant with fontconfig). Examples: 'Sans', 'URW Bookman L:style=Demi Bold Italic'.
font_sizeinteger
The font size in points. A font size of 16 is the default.
default: 16
font_colorstring
See https://www.ffmpeg.org/ffmpeg-utils.html#Color for valid definitions. Example: blue: opaque blue, green@0.8: green with 0.8 alpha.
default: green
background_colorstring
See https://www.ffmpeg.org/ffmpeg-utils.html#Color for valid definitions. Example: blue: opaque blue, green@0.8: green with 0.8 alpha.
border_sizeinteger
Size of a border being drawn in background color.
default: 0
timecode_kindenum                          
timecode_auto
timecode_drop
timecode_nodrop
frame_nr
media_time
Choose the time/timecode format. If timecode_auto is used, drop/non-drop is chosen based on the frame rate.
default: timecode_auto
timecode_sourceenum                          
auto
start_value
media
Select the timecode source for imprinting.
default: media
source_timecode_selectorenum                          
first
highest
lowest
mxf
gop
sdti
smpte
material_package
source_package
Specifies the metadata track to be used for time code data. [DESC]
default: first
timecode_start_valuestring
Start time. The units depends on the kind. Only valid for timecode_source=start_value.
lut_fileobjectAllows referencing hosted LUT files, for example for SDR imprint into HDR video.
lut_presetenum                          
r709_to_r2020_pq_300nit
The LUT preset selection.

Example print_timecode

{
"uid": "transcode_task",
"kind": "transcode",
"payload": {
"location": {
},
"targets": [
{
"file_pattern": "{source_basename}_converted.mp4",
"container": {
"kind": "mp4"
},
"video": {
"codec": "h264",
"filters": [
{
"kind": "print_timecode",
"payload": {
"x": "(w-tw)/2",
"y": "h/4",
"font_size": 20,
"source_timecode_selector": "gop"
}
}
]
},
"audio": [
{
}
]
}
]
}
}