Translate SRT subtitle files with Hyperlocalise

​

Source file

1
00:00:01,000 --> 00:00:04,000
Welcome to the product tour.

2
00:00:05,000 --> 00:00:08,000
Open your project to begin.

​

Configure your files

locales:
    source: en-US
    targets:
        - es-ES

buckets:
    messages:
        files:
            - from: locales/en-US/messages.srt
              to: locales/{{target}}/messages.srt

llm:
    profiles:
        default:
            provider: openai
            model: gpt-5.2

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• Each cue is one translation unit, including multiline text. Keys are sequential, such as srt.0001.
• Cue numbers, timestamps, and positioning remain unchanged. Timing is supplied as translation context.
• Writeback replaces cue text. Extra keys are ignored, and blank lines inside translated text are removed to avoid creating new cues.
• Review subtitle length and reading speed separately; translation does not retime your video.

​

Next steps

• Check translations before committing generated files.
• Local translation workflow explains repeat runs.
• Browse all file formats.

​

Related formats

• WebVTT subtitle