Subtitle Overlap Fix API

POST https://api.findutils.com/api/tools/subtitle-overlap-fix/execute

Fix overlapping cues in a SubRip (.srt) or WebVTT (.vtt) caption file, the kind a merge, shift or frame-rate change leaves behind and that makes players skip or flash lines. Cues are sorted by start time, then every cue that starts before the previous one ends is moved to start exactly when the previous one ends; if that leaves it shorter than min_duration_ms (default 300), its end is extended to reach that length. Cue text is never changed and no cue is dropped. Returns the fixed file, counts, and the first adjustments so the change can be checked.

Open the tool Try it

Request body

application/json

input

string required

Caption file contents, either SubRip or WebVTT.
min_duration_ms

integer optional

The shortest a moved cue may last, in milliseconds. Default 300, between 100 and 1000. Default 300.
sort

boolean optional

Sort cues by start time before fixing. Default: true. Default true.

Example arguments

Verified

{
  "input": "1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"
}

curl -X POST https://api.findutils.com/api/tools/subtitle-overlap-fix/execute \
  -H "Content-Type: application/json" \
  -d '{
    "input": "1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"
  }'

const response = await fetch('https://api.findutils.com/api/tools/subtitle-overlap-fix/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"input":"1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/subtitle-overlap-fix/execute",
    json={"input":"1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/subtitle-overlap-fix/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"input":"1\n00:00:01,000 --> 00:00:04,000\nFirst line.\n\n2\n00:00:03,000 --> 00:00:06,000\nSecond line starts too early.\n"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call subtitle_overlap_fix from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: subtitle-overlap-fix
MCP name: subtitle_overlap_fix
Category: Media
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Media tools

More to explore