Welcome to pycaption’s documentation!

pycaption is a Python library for reading, converting, and writing closed caption formats. It supports bidirectional conversion between DFXP/TTML, SAMI, SCC, SRT, WebVTT, and MicroDVD — preserving styling, positioning, and timing information where the target format allows.

Table of contents

• Introduction
  • Quick Start
  • Format Detection
  • Conversion Examples
    • WebVTT to SCC
    • SCC to WebVTT
    • SAMI to DFXP
  • Default Language
  • Positioning
    • BaseWriter
    • DFXP to WebVTT (with relativization)
    • DFXP to DFXP (fit-to-screen)
• Supported formats
  • SAMI Reader / Writer :: spec
  • DFXP/TTML Reader / Writer :: spec
  • SRT Reader / Writer :: spec
  • WebVTT Reader / Writer :: spec
    • Styling
    • Positioning
  • SCC Reader / Writer :: spec
  • MicroDVD Reader / Writer
  • Transcript Writer
• Extensibility
• Changelog
  • 2.3.9
  • 2.3.8
  • 2.3.7
  • 2.3.6
  • 2.3.5
  • 2.3.4
  • 2.3.3
  • 2.3.2
  • 2.3.1
  • 2.3.0
  • 2.2.28
  • 2.2.27
  • 2.2.26
  • 2.2.25
  • 2.2.24
  • 2.2.23
  • 2.2.22
  • 2.2.21
  • 2.2.20
  • 2.2.19
  • 2.2.18
  • 2.2.17
  • 2.2.16
  • 2.2.15
  • 2.2.14
  • 2.2.13
  • 2.2.12
  • 2.2.11
  • 2.2.10
  • 2.2.9
  • 2.2.8
  • 2.2.7
  • 2.2.6
  • 2.2.5
  • 2.2.4
  • 2.2.3
  • 2.2.2
  • 2.2.1
  • 2.2.0
  • 2.1.1
  • 2.1.0
  • 2.0.9
  • 2.0.8
  • 2.0.7
  • 2.0.6
  • 2.0.5
  • 2.0.4
  • 2.0.3
  • 2.0.2
  • 2.0.1
  • 2.0.0
  • 1.0.7
  • 1.0.6
  • 1.0.5
  • 1.0.4
  • 1.0.3
  • 1.0.2
  • 1.0.0
  • 0.5.x