whatisgithub

What is jellyfin-plugin-subtitleocr?

idisposable/jellyfin-plugin-subtitleocr — explained in plain English

Analysis updated 2026-05-18

12C#Audience · generalComplexity · 3/5LicenseSetup · moderate

In one sentence

A Jellyfin plugin that reads picture based DVD and Blu-ray subtitles and converts them into normal, searchable SRT or ASS text subtitle files.

Mindmap

mindmap
  root((subtitle ocr))
    What it does
      Converts image subtitles to text
      Supports VobSub and PGS
      Outputs SRT or ASS files
    Tech stack
      C sharp
      Jellyfin plugin
      ffprobe and ffmpeg
    Use cases
      Make DVD subtitles searchable
      Fix Blu-ray subtitle tracks
      Batch process a large library
    Audience
      Self hosted media server owners
      Home theater enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert picture based DVD subtitles across a whole media library into searchable SRT files.

USE CASE 2

Fix Blu-ray subtitle tracks that Jellyfin cannot display as normal text.

USE CASE 3

Reuse a subtitle recognition database already trained in Subtitle Edit inside Jellyfin.

USE CASE 4

Automatically detect and label hearing impaired subtitle tracks that discs left untagged.

What is it built with?

C#JellyfinFFmpeg.NET

How does it compare?

idisposable/jellyfin-plugin-subtitleocrarcademakersources/arcademakerautomatic1111/startupimpact
Stars121212
LanguageC#C#C#
Last pushed2022-06-24
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencegeneraldevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing Jellyfin 10.11 server with a matching plugin ABI version.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

This is a plugin for Jellyfin, a self hosted media server, that solves a specific problem: some movies and TV shows have subtitles that are actually pictures of text rather than text you can search or edit, a format used on DVDs and Blu-rays. This plugin reads those picture based subtitles and converts them into normal text subtitle files, either the common SRT format or the ASS format, so they behave like any other subtitle track. It does this using its own pattern matching approach rather than relying on a general purpose text recognition tool like Tesseract, and it needs no extra native software installed since it is written entirely in managed code. The database it uses to recognize letters is compatible with the one used by a separate, well known subtitle tool called Subtitle Edit, so a database someone has already trained or corrected in that program's interface can be reused here directly. To pull the subtitle tracks out of a video file in the first place, the plugin relies on ffprobe and ffmpeg, which Jellyfin already includes, rather than bundling its own copy. The plugin is currently labeled beta. According to the README, its core logic has been tested and its Jellyfin integration has been run against a real server managing a library of fourteen thousand items. It automatically figures out whether a subtitle should be exported as SRT or ASS depending on whether the original needs special positioning or color, detects light-on-dark versus dark-on-light text automatically per track, and never overwrites your original or hand made subtitles because its output always gets its own distinct filename. It also applies some conservative text corrections, such as fixing commonly confused letters, and can optionally run a spell checker. It is installed like most Jellyfin plugins: either by adding the project's plugin repository URL inside Jellyfin's dashboard and installing Subtitle OCR from the catalog, or by downloading the release file manually and placing it in Jellyfin's plugins folder. It is released under the MIT license, and its README notes the version of Jellyfin it currently targets.

Copy-paste prompts

Prompt 1
Walk me through installing the Subtitle OCR plugin repository in my Jellyfin dashboard.
Prompt 2
Explain the difference between VobSub and PGS subtitle formats and why this plugin needs ffprobe and ffmpeg.
Prompt 3
Show me how to reuse a Subtitle Edit trained OCR database with this Jellyfin plugin.
Prompt 4
Explain how this plugin decides whether to output SRT or ASS for a given subtitle track.

Frequently asked questions

What is jellyfin-plugin-subtitleocr?

A Jellyfin plugin that reads picture based DVD and Blu-ray subtitles and converts them into normal, searchable SRT or ASS text subtitle files.

What language is jellyfin-plugin-subtitleocr written in?

Mainly C#. The stack also includes C#, Jellyfin, FFmpeg.

What license does jellyfin-plugin-subtitleocr use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is jellyfin-plugin-subtitleocr to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is jellyfin-plugin-subtitleocr for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.