== Description Submarine is a command-line program for searching and downloading the right subtitles for movies. Subtitles are searched based on movie file hashes and downloaded from online subtitle services. Downloaded subtitles are automatically renamed and saved next to corresponding files.
submarine [OPTION…] FILE…
-l CODE, --language=CODE
Select language to filter subtitles. CODE is a 2 or 3 letter language code (ISO-639-1 and ISO-639-2). Avaliable options can be listed with
-l help. This option can be specified multiple times. By default, only english (
en) language is selected.
-s CODE, --server=CODE
Select server to use for searching subtitles. CODE is a 2 letter server code. Avaliable options can be listed with
-s help. This option can be specified multiple times. By default,
allservers are selected.
Replace all existing subtitles. Existing subtitles are deleted even if they don’t have the same extension as the new ones.
Quiet mode. Don’t output any messages or warnings.
Verbose mode. Output all messages and warnings.
Display version information and exit.
Display help message and exit.
Download a subtitle in Slovenian or Croatian language:
submarine -l slv -l hr USS_Barracuda.avi
Download subtitles for mutliple files:
Download subtitles only from OpenSubtitles:
submarine -s os Zulu.mkv U-boat.mp4
submarine -l slv -l hr -s os USS_Barracuda.avi Season01/*.mpg Zulu.mkv U-boat.mp4
Submarine is developed on and for GNU/Linux, although it may work on other Unix platforms.
Submarine has little dependencies and is really lightweight.
autotools (autoconf, automake, libtool,…)
To build submarine, run the following commands:
./autogen.sh ./configure make
To install submarine, run the following commands:
Any kind of code fix/addition, translation, bug report, feature request, etc. is highly appreciated.
If you really like this project consider Flattring it on Flattr:
== Powered by This program is based on the following online subtitle services: