Merge subtitles | agent view
The same page content and links, with explicit tool capabilities. Tools marked with an API can run directly through HTTP. Other tools require the browser interface or are not connected yet.
Tool capabilities
{
"id": "merge-subtitles",
"category": "subtitle-tools",
"built": true,
"requirements": "Merge timelines with offset and overlap handling; preserve original ordering options.",
"implementation": {
"fields": [],
"files": true,
"multiple": true,
"input": false,
"accept": ".srt,.vtt",
"note": "Merges on the existing timeline; files are not concatenated end-to-end.",
"experience": {
"automatic": false,
"single": false,
"label": "Your text",
"placeholder": "Type or paste your input…",
"help": "Up to 1,000,000 characters. Review the settings before running.",
"action": null
},
"mode": "explicit",
"interactive": false
},
"execution": "POST /api/v1/tools/merge-subtitles/run",
"api": {
"id": "merge-subtitles",
"name": "Merge subtitles",
"category": "subtitle-tools",
"description": "Merge timelines with offset and overlap handling.",
"notes": "Merges on the existing timeline; files are not concatenated end-to-end.",
"human_path": "/en/subtitle-tools/merge-subtitles/",
"method": "POST",
"endpoint": "/api/v1/tools/merge-subtitles/run",
"schema_url": "/api/v1/tools/merge-subtitles",
"input_schema": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"maxLength": 1000000,
"default": "",
"description": "Plain text input. File tools use files instead unless otherwise documented."
},
"options": {
"type": "object",
"additionalProperties": false,
"properties": {}
},
"files": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"required": [
"name",
"base64"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"description": "Filename only, no path."
},
"mime": {
"type": "string",
"maxLength": 150
},
"bytes": {
"type": "integer",
"minimum": 0,
"description": "Optional decoded byte count; must match content if supplied."
},
"base64": {
"type": "string",
"contentEncoding": "base64",
"description": "File bytes as padded base64. Use the tool-specific limits.files_bytes value for the total decoded input size."
}
}
}
}
}
},
"output_schema": {
"type": "object",
"required": [
"tool",
"result"
],
"properties": {
"tool": {
"type": "string"
},
"result": {
"type": "object",
"required": [
"text",
"files"
],
"properties": {
"text": {
"type": [
"string",
"null"
]
},
"data": {
"description": "Parsed JSON when the textual result is JSON."
},
"name": {
"type": "string"
},
"mime": {
"type": "string"
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"mime",
"bytes",
"base64"
],
"properties": {
"name": {
"type": "string"
},
"mime": {
"type": "string"
},
"bytes": {
"type": "integer"
},
"base64": {
"type": "string",
"contentEncoding": "base64"
}
}
}
}
}
}
}
},
"processing": "Server; same transformation code as browser tools",
"limits": {
"request_bytes": 8388608,
"input_characters": 1000000,
"files_bytes": 5242880,
"max_files": 20,
"timeout_seconds": 12
}
},
"agent_processing": "Server; same transformation code as browser tools",
"browser_agent": {
"supported": true,
"name": "run_current_tool",
"discovery": "WebMCP on the human page in a supporting browser",
"verification": "See audit/API-AUDIT.md; availability is not verification"
}
}Page guide
Merge timelines with offset and overlap handling.
Useful next steps
How to use Merge subtitles
- Choose one or more files in SRT or VTT.
- Review the settings, then choose Run Merge subtitles.
- Review the result, then use Copy result or a download link when available.
Working with merge subtitles
A subtitle file combines text with time ranges. Converting SRT to VTT changes its representation; shifting subtitles changes timing; translation changes the language. Generating subtitles from speech adds a transcription step before the captions can be reviewed.
Common questions
Does converting subtitle formats fix synchronization?
No. A format conversion generally retains the source timing. Constant offsets can be adjusted with a shift; drift across a recording may require timing alignment or manual correction.
Why do translated subtitles need another review?
Translated text may be longer than the original even when its meaning is correct. Review line breaks and reading speed without assuming that the original cue duration suits every language.
Continue your workflow: SRT to VTT, VTT to SRT, Shift subtitles.