madoo.video-text-track/v1

Madoo video text track — Timed text events rendered together over a video by Video Text Overlay, in one encoding pass.

Reference	madoo.video-text-track/v1
Schema id	urn:madoo:schema:video-text-track:v1
Version	1.0.0
Served at	GET /api/v1/json-schemas/madoo.video-text-track/v1 · MCP get_json_schema

Where it appears

• Read by: video/text_overlay → text_track
• Saved in the parameter: video/text_overlay → text_track

Fields

Field	Type	Required	Rules	Description
schema	"madoo.video-text-track/v1"	yes
events	array of objects	yes	min items 1
events[].id	string	yes	min length 1	Stable identifier of the event, unique in the track.
events[].text	string	yes	min length 1	The text to show. Line breaks are kept.
events[].start	number	yes	≥ 0	Second at which the text appears.
events[].end	number	yes	≥ 0	Second at which the text disappears; greater than start.
events[].typography	object or null			Optional style for this event only: a madoo.video-typography/v1 object (read it with get_json_schema).

The complete schema

madoo.video-text-track/v1 (JSON Schema)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:madoo:schema:video-text-track:v1",
  "title": "Madoo video text track",
  "description": "Timed text events that Video Text Overlay renders together over a video in one encoding pass. Each event shows its text from start to end (seconds); an end past the video is cut at its end. An event without typography uses the node's typography parameter.",
  "type": "object",
  "required": [
    "schema",
    "events"
  ],
  "properties": {
    "schema": {
      "const": "madoo.video-text-track/v1"
    },
    "events": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "id",
          "text",
          "start",
          "end"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Stable identifier of the event, unique in the track."
          },
          "text": {
            "type": "string",
            "minLength": 1,
            "description": "The text to show. Line breaks are kept."
          },
          "start": {
            "type": "number",
            "minimum": 0,
            "description": "Second at which the text appears."
          },
          "end": {
            "type": "number",
            "minimum": 0,
            "description": "Second at which the text disappears; greater than start."
          },
          "typography": {
            "type": [
              "object",
              "null"
            ],
            "description": "Optional style for this event only: a madoo.video-typography/v1 object (read it with get_json_schema)."
          }
        }
      }
    }
  },
  "examples": [
    {
      "schema": "madoo.video-text-track/v1",
      "events": [
        {
          "id": "place",
          "text": "MANAROLA - LIGURIA",
          "start": 0.5,
          "end": 10.4
        },
        {
          "id": "title",
          "text": "Colori sul mare",
          "start": 0.7,
          "end": 10.4
        },
        {
          "id": "price",
          "text": "da 485 EUR",
          "start": 2,
          "end": 10.4
        }
      ]
    }
  ]
}