SS

Automatically finds subtitles for multiple movies using OpenSubtitle.org APIs

This project is maintained by nicoddemus

Subtitle Searcher - SS

Command line script for searching video subtitles using OpenSubtitles.org APIs.

OpenSubtitles.org

version downloads ci coverage

Features

Install

Install using pip:

pip install ss

Requirements

Usage

Pass the name of one or more video files or directories:

screenshot

It will try to find the best match online, and automatically download and move the subtitles to the same folder as the video files.

Configuration

Configuration is stored in ~/.ss.ini (or C:\Users\<user>\.ss.ini on Windows) as a standard ini file:

[ss]
languages=eng, pob
recursive=yes
skip=yes
mkv=no

The following options are available:

Support

If you find any issues, please report it in the issues page.

Changelog

See the releases page.