Repository navigation
docs(spec): subtitle sidecars for --to web (roadmap phase 14) - #175
Merged
Merged
Conversation
A browser does not show in-band mov_text, so --to web drops every subtitle today. The spec writes each text subtitle as a WebVTT sidecar in a separate ffmpeg step after the ladder, guards every sidecar path by the grammar of its name so selection stays probe-free, and authors the vision, architecture and three design carriers for ratification. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
An MP4 at its final path counts as done (constraint-determined), sidecars are never rolled back, the stale sweep compares through normcase rather than casefold, ASS/SSA are always noted, and placement, note order and the plan type are fixed so the implementer meets no fork. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
First same-language stream bare, further ones numbered from 2 per language; no styling note for SubRip or mov_text; an MP4 at its final path is done, confirmed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Spec for roadmap phase 14:
--to webwrites every text subtitle stream as a WebVTT sidecar beside the MP4, because no browser shows an in-bandmov_texttrack in a plain<video>..partialoutput per sidecar) — a broken subtitle never costs the video a re-encode.cli.pyneeds no diff.filerecord gainssidecars(schema stays 1).Three decisions are open for the acceptance gate (duplicate-language naming, whether an MP4 with a missing sidecar counts as done, which codecs earn a styling note).
Docs-only; closes no issue.
🤖 Generated with Claude Code