# Timed Transcript Caption Packager Local source edition 1.0.0. Convert timed words into SRT and WebVTT subtitles with line wrapping, speaker breaks, a timeline offset and a cue sheet. ## Run locally Extract the complete ZIP. Use Python 3.12 from a terminal in the extracted directory. The tool uses the Python standard library. python run.py example.json results Use a new output folder for each run. Start with example.json and replace its synthetic values with your own data. Preserve field names, types and units. Files and reports are processed on your computer. ## Inputs Supply 1–3000 words with text, integer startMs and endMs, and optional speaker. Timestamps must be ordered with no overlap. Plain text tokens only. Options control offsetMs, lineChars (10–80), maxDurationMs (500–15000) and pauseMs. Shifted times must stay nonnegative. ## Results Download CAPTIONS.srt, CAPTIONS.vtt and CUES.csv. Each cue uses at most two lines. A pause, speaker change, width or duration limit starts a new cue. Speaker names stay in the cue sheet. Use timestamps from your transcription or editor. The results folder includes summary.json and the output files produced by this input. The sample produces: CAPTIONS.srt, CAPTIONS.vtt, CUES.csv. ## Español · Generador de subtítulos con marcas de tiempo Convierte palabras con tiempos en subtítulos SRT y WebVTT con cortes por hablante y una hoja de entradas. Extrae el ZIP completo y abre una terminal en esa carpeta con Python 3.12. El programa usa la biblioteca estándar de Python. Ejecuta: python run.py example.json resultados Copia example.json para preparar tus datos. Conserva los nombres y tipos de los campos, usa una carpeta de salida nueva y consulta summary.json junto con los archivos generados. La descripción detallada de los campos está en inglés. The included LICENSE covers use and modification for your own personal and commercial projects. This edition includes its source and can run locally after setup.