amine1u1/subtitleextractor repository overview

⁠Subtitle Extractor

This extracts embedded subtitles & attachments of all .mkv files in the volume mounted to /data. They are extracted in a subfolder for each file.

It works best as a Docker container hosted to provide subtitles & attachments in an automated fashion.

The Docker image size is kept very small by using multi-stage build to compile minimal FFMPEG binaries from source.

Subtitles are saved as .ass files by default following a template, and attachments keep their original filename and extension.

For each file FileName.mkv, its attachments & subtitles will be saved under FileName/, and the subtitles will be named SubtitleName_SubtitleNumber_lang_FileName.OUT_EXT, with OUT_EXT being 'ass' by default.

⁠Environment variables

• LANGS allows to specify the languages to extract. Use their language codes, separated by a space, to extract only these. Defaults to extract all languages. Subtitles without language ('und') are always extracted.

  example : LANGS=eng fre

• OUT_EXT defines the ouput extension of the subtitles files. Accepts any subtitle format supported by ffmpeg, and is properly converted from the input subtitle. Defaults to 'ass'.

  example : OUT_EXT=srt

• SUBFOLDER If defined, all subtitles & attachments will be extracted in a subfolder of SUBFOLDER : In "SUBFOLDER/videofilename/", instead of only "videofilename/".

  example : SUBFOLDER=subtitles.

⁠Usage Examples

Mounting folders as volume, in a Linux environment (Run these from WSL2 if you are using this on Windows)

⁠Extract all subtitles & all attachments

docker run --rm -it -v /AFolderWithMKVFiles:/data amine1u1/subtitleextractor

⁠Extract subtitles of specific languages, & all attachments

docker run --rm -it -v /APathWithMKVFiles:/data -e 'LANGS=eng fre' amine1u1/subtitleextractor

⁠Extract all subtitles to a specific extension (ffmpeg does any eventual conversion), & all attachments

docker run --rm -it -v /AFolderWithMKVFiles:/data -e 'OUT_EXT=srt' amine1u1/subtitleextractor

⁠Notes, credits & Licences

Credits & thanks to the ffmpeg developer team.

The code in the repo is subject to the unlicence, and the Docker Image, containing a compiled ffmpeg static binary, is under GPL.