11 releases

0.2.0 Aug 18, 2024
0.1.9 May 28, 2024
0.1.8 Feb 25, 2024
0.1.7 Jun 30, 2023
0.1.0 Oct 13, 2020

#312 in Filesystem

50 downloads per month
Used in 2 crates

MIT/Apache

36KB
550 lines

srtlib

Build Status Version Crates.io Total Downloads License

A simple Rust library for handling .srt subtitle files.

srtlib allows you to handle subtitle files as collections of multiple subtitle structs, letting you modify the subtitles without directly messing with the .srt files.

Subtitle collections can be generated by parsing strings or files, but also from the ground up, enabling total control of all the elements of each subtitle.

Usage

Add this to your Cargo.toml:

[dependencies]
srtlib = "0.1"

To read a .srt file:

use srtlib::Subtitles;

// Parse subtitles from file that uses the utf-8 encoding.
let mut subs = Subtitles::parse_from_file("subtitles.srt", None).unwrap();

You can now perform any action you want on the subtitles. For example to move all subtitles 10 seconds forward in time:

// Move every subtitle 10 seconds forward in time.
for s in &mut subs {
    s.add_seconds(10);
}

Finally we can write the subtitles back to a .srt file:

subs.write_to_file("subtitles_fixed.srt", None).unwrap();

For more examples refer to the documentation.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~3.5MB
~119K SLoC