subtitler 2.6.1

Parse, convert, validate, edit, and generate subtitles in 15 formats (SRT, VTT, ASS/SSA, MicroDVD, SubViewer, TTML, SBV, LRC, SAMI, MPL2, SCC, EBU STL, DFXP, Whisper JSON). Full CLI included.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub enum ValidationIssue {
  Overlap {
    index_a: usize,
    index_b: usize,
    end_a: u64,
    start_b: u64,
  },
  NegativeDuration {
    index: usize,
    start: u64,
    end: u64,
  },
  ZeroDuration {
    index: usize,
    time: u64,
  },
  DecreasingStartTime {
    index: usize,
    prev_start: u64,
    curr_start: u64,
  },
  TooLongGap {
    index: usize,
    prev_end: u64,
    curr_start: u64,
    gap_ms: u64,
  },
  TextTooLong {
    index: usize,
    chars: usize,
    max_chars: usize,
  },
  CpsTooHigh {
    index: usize,
    cps: f64,
    max_cps: f64,
  },
}

impl std::fmt::Display for ValidationIssue {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    f.write_str(&self.description())
  }
}

impl ValidationIssue {
  pub fn description(&self) -> String {
    match self {
      ValidationIssue::Overlap {
        index_a,
        index_b,
        end_a,
        start_b,
      } => {
        format!(
          "subtitle {index_a} (ends at {end_a}ms) overlaps with subtitle {index_b} (starts at {start_b}ms)"
        )
      }
      ValidationIssue::NegativeDuration { index, start, end } => {
        format!("subtitle {index} has negative duration: {start}ms -> {end}ms")
      }
      ValidationIssue::ZeroDuration { index, time } => {
        format!("subtitle {index} has zero duration at {time}ms")
      }
      ValidationIssue::DecreasingStartTime {
        index,
        prev_start,
        curr_start,
      } => {
        format!(
          "subtitle {index} starts at {curr_start}ms before previous subtitle's start time {prev_start}ms"
        )
      }
      ValidationIssue::TooLongGap {
        index,
        prev_end,
        curr_start,
        gap_ms,
      } => {
        format!("subtitle {index}: {gap_ms}ms gap between {prev_end}ms and {curr_start}ms")
      }
      ValidationIssue::TextTooLong {
        index,
        chars,
        max_chars,
      } => {
        format!("subtitle {index} has {chars} characters (max recommended: {max_chars})")
      }
      ValidationIssue::CpsTooHigh {
        index,
        cps,
        max_cps,
      } => {
        format!("subtitle {index} has {cps:.1} chars/second (max recommended: {max_cps:.1})")
      }
    }
  }
}