subtitler 1.2.0

Parse, convert, validate, edit, and generate subtitles in 9 formats (SRT, VTT, ASS/SSA, MicroDVD, SubViewer, TTML, SBV, LRC). 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

//! Edit operations: shift, sort, merge, split, enforce duration.
//!
//! Run: cargo run --example edit-operations

use subtitler::SubtitleFormat;
use subtitler::model::{Subtitle, SubtitleFile};

fn sample() -> SubtitleFile {
  SubtitleFile::Srt(vec![
    Subtitle::new(5000, 7000, "C (out of order)"),
    Subtitle::new(1000, 3000, "A (first)"),
    Subtitle::new(3100, 5000, "B (close to A)"),
    Subtitle::new(8000, 8500, "D (too short)"),
    Subtitle::new(
      9000,
      9000 + 6000,
      "This is a very long subtitle that exceeds the recommended character limit for a single line",
    ),
  ])
}

fn show(label: &str, file: &SubtitleFile) {
  let subs = file.subtitles();
  println!("  {} ({} subs):", label, subs.len());
  for (i, s) in subs.iter().enumerate() {
    println!(
      "    [{}] {}-{}ms '{}'",
      i,
      s.start,
      s.end,
      if s.text.len() > 40 {
        &s.text[..40]
      } else {
        &s.text
      }
    );
  }
}

fn main() {
  println!("=== Sort ===");
  let mut f = sample();
  show("Before", &f);
  f.sort();
  show("After ", &f);

  println!("\n=== Shift +1000ms ===");
  let mut f = sample();
  f.sort();
  f.shift_all(1000);
  show("After", &f);

  println!("\n=== Merge adjacent (gap <= 200ms) ===");
  let mut f = sample();
  f.sort();
  f.merge_adjacent(200);
  show("After", &f);

  println!("\n=== Enforce min duration (2000ms) ===");
  let mut f = sample();
  f.sort();
  f.enforce_min_duration(2000);
  show("After", &f);

  println!("\n=== Split long (>20 chars) ===");
  let mut f = sample();
  f.sort();
  f.split_long(20);
  show("After", &f);

  println!("\n=== Remove overlaps ===");
  let mut f = SubtitleFile::Srt(vec![
    Subtitle::new(1000, 5000, "overlapping A"),
    Subtitle::new(3000, 6000, "overlapping B"),
  ]);
  show("Before", &f);
  f.remove_overlaps();
  show("After ", &f);

  println!("\n=== Auto-extend for CPS (max 15) ===");
  let mut f = SubtitleFile::Srt(vec![Subtitle::new(
    0,
    1000,
    "This text is way too long for one second",
  )]);
  show("Before", &f);
  f.auto_extend_for_cps(15.0);
  show("After ", &f);
}