Structured
Stable Cue JSON exposes timing, text, native format details, diagnostics, and source provenance.
Cueson v1.0.0
Universal captions and subtitles.
A lossless, structured interchange layer for subtitle and caption content. Parse, preserve, inspect, validate, render, and convert SubRip and WebVTT through one stable Cue JSON surface.
go install github.com/shruggietech/cueson/cmd/cueson@v1.0.0Cue JSON
00:00:01.250 → 00:00:03.800The words stay addressable.
source · preserved · sha256The original carrier stays intact.
SRT ⇄ VTT · explicit loss reportConversion stays honest.
Stable v1 contract
One precise surface for caption content.
Cueson keeps source evidence separate from derived structure, giving tools a predictable model without discarding what arrived.
Lossless
Restore original source bytes exactly while deterministic rendering remains a separate, explicit operation.
Format-literate
Convert SubRip and WebVTT with complete loss reporting and strict rejection when fidelity matters.
First command
Turn subtitles into Cue JSON.
Encode a SubRip or WebVTT file into the stable structured contract. The source envelope preserves the original bytes for exact restoration.
cueson encode --pretty --output document.cueson.json subtitles.srtUse the contract
Start with the source of truth.
Documentation
Read the complete CLI, schema, format, conversion, compatibility, and architecture contracts.
Open documentation →Versioned schema
Resolve the immutable released Cue JSON schema without a mutable latest alias.
Open v1 schema →Media-format guide
Explore the broader caption, subtitle, transcript, and timed-text landscape.
Open the guide →Native release
Download Cueson v1.0.0.
Choose the archive for your platform, then verify it with the published SHA-256 checksum manifest.