GoSaveTool.
Copy Markdown
SRT and WebVTT: read cues, write them in either format, shift and repair timings. The Elixir version of
@gosavetool/subtitles.
Online editor: https://www.gosavetool.com/vtt-subtitle-generator
iex> GoSaveTool.Subtitles.convert("1\n00:00:01,000 --> 00:00:02,500\nHello\n", :vtt)
"WEBVTT\n\n00:00:01.000 --> 00:00:02.500\nHello\n"Summary
Functions
Converts a subtitle text to :srt or :vtt.
Milliseconds to "00:01:02,500" (separator ",", SRT) or "00:01:02.500" (separator ".", WebVTT).
Cues of an SRT or WebVTT text. Headers, NOTE and STYLE blocks are skipped.
Repairs common faults: cues out of order, an end before its start, overlapping cues and empty cues.
Returns {cues, number_of_changes}. Cues that end before they start get min_duration milliseconds.
Moves every cue by ms (negative = earlier); cues pushed before zero are clipped or dropped.
"00:01:02,500" or "01:02.5" to milliseconds; nil when it is not a timestamp.
SRT text, numbered from 1.
WebVTT text; cue settings are kept.
True when the text starts with the WEBVTT signature.
Functions
Converts a subtitle text to :srt or :vtt.
Milliseconds to "00:01:02,500" (separator ",", SRT) or "00:01:02.500" (separator ".", WebVTT).
iex> GoSaveTool.Subtitles.from_ms(3723004)
"01:02:03,004"@spec parse(String.t()) :: [GoSaveTool.Subtitles.Cue.t()]
Cues of an SRT or WebVTT text. Headers, NOTE and STYLE blocks are skipped.
@spec repair([GoSaveTool.Subtitles.Cue.t()], non_neg_integer()) :: {[GoSaveTool.Subtitles.Cue.t()], non_neg_integer()}
Repairs common faults: cues out of order, an end before its start, overlapping cues and empty cues.
Returns {cues, number_of_changes}. Cues that end before they start get min_duration milliseconds.
@spec shift([GoSaveTool.Subtitles.Cue.t()], integer()) :: [ GoSaveTool.Subtitles.Cue.t() ]
Moves every cue by ms (negative = earlier); cues pushed before zero are clipped or dropped.
@spec to_ms(String.t()) :: non_neg_integer() | nil
"00:01:02,500" or "01:02.5" to milliseconds; nil when it is not a timestamp.
iex> GoSaveTool.Subtitles.to_ms("1:02:03.4")
3723400@spec to_srt([GoSaveTool.Subtitles.Cue.t()]) :: String.t()
SRT text, numbered from 1.
@spec to_vtt([GoSaveTool.Subtitles.Cue.t()]) :: String.t()
WebVTT text; cue settings are kept.
True when the text starts with the WEBVTT signature.