Skip to content
Subtitle engine for reading, manipulating / transforming and saving subtitle files.
Go HTML CSS Batchfile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd
exec
web
.travis.yml
LICENSE.md
README.md
config.go
doc.go
example_test.go
sub_station_alpha.go
subrip.go
subspack.go
subtitle.go
writer.go

README.md

Srtgears™

GoDoc Build Status Go Report Card

Srtgears™ is a subtitle engine for reading subtitle files, manipulating / transforming them and then saving the result into another file.

Srtgears provides some very handy features which are not available in other subtitle tools, for example:

  • merge 2 subtitle files to have dual subs: one at the bottom, one at the top (this is not concatenation, but that's also supported)
  • lengthen / shorten display duration of subtitles (if you're a slow reader, you're gonna appreciate this :))
  • remove hearing impaired (HI) texts (such as "[PHONE RINGING]" or "(phone ringing)")
  • strip off formatting (such as <i>, <b>, <u>, <font>)
  • split the subtitle file at a specified time
  • statistics from the subtitles
  • etc...

Home page: https://srt-gears.appspot.com

Presentation

The Srtgears engine is presented in 3 ways:

1. Command line tool

Srtgears is available as a command line tool for easy, fast, scriptable and repeatable usage.

Binary (compiled) distributions are available on the download page:

https://srt-gears.appspot.com/download.html

The command line tool uses only the Go standard library and the srtgears engine (see below).

2. Web interface: online web page

Srtgears can also be used on the web for those who do not want to download the tool just try it out from the browser. It can be found here:

https://srt-gears.appspot.com/srtgears-online.html

The web interface is a Google App Engine project, implemented using the Go AppEngine SDK. The server side of the web interface uses the srtgears engine (see below).

The web folder is the root of the App Engine project. If you want to try it locally, you need to download the Go AppEngine SDK, and it can be started locally by running the goapp serve command of the SDK from the web folder.

3. Srtgears engine: a Go package

And last (but not least) a Go package for developers. The engine was designed to be independent from the command line and web interfaces, its API is clear, well documented and easy-to-use.

To get the source code (along with the sources of the tool and web interface), use go get:

go get github.com/icza/srtgears

Documentation can be found at:

http://godoc.org/github.com/icza/srtgears

To use the engine, first import it:

import "github.com/icza/srtgears"

And for example using the engine to merge 2 subtitle files to have a dual sub saved in Sub Station Alpha (*.ssa) format:

sp1, err := srtgears.ReadSrtFile("eng.srt")
check(err) // Check / handle error
sp2, err := srtgears.ReadSrtFile("hun.srt")
check(err) // Check / handle error
sp1.Merge(sp2)
err = srtgears.WriteSsaFile("eng+hun.ssa", sp1);
check(err) // Check / handle error

You can see more usage examples in the package doc.

Also worth noting that the subtitle transformations of the command line tool and the web interface are driven by the same Executor, it is "outsourced" to the github.com/icza/srtgears/exec package.

Limits

Input files must be UTF-8 encoded, output files will be UTF-8 encoded as well.

Supported input format is SubRip (*.srt) only, supported output formats are SubRip (*.srt) and Sub Station Alpha (*.ssa).

It should also be noted that SubRip format specification does not include subtitle positioning. Srtgears uses an unofficial extension {\anX} which may not be supported by all video players, or some players interpret the position values differently. MPC-HC has full support for it. In these cases the Sub Station Alpha output format is recommended (where the specification covers subtitle positioning / alignment).

Story

Srtgears started as a 48-hour work created for the Gopher Gala 2016 event. The initial version can be found here. I was competing solo.

License

See LICENSE

You can’t perform that action at this time.