https://github.com/zeryther/jellyfin-extract-subtitles-docker

Extract Jellyfin Subtitles manually to avoid issues
https://github.com/zeryther/jellyfin-extract-subtitles-docker

api docker jellyfin mkv python subtitles

Last synced: 4 days ago
JSON representation

Extract Jellyfin Subtitles manually to avoid issues

• Host: GitHub
• URL: https://github.com/zeryther/jellyfin-extract-subtitles-docker
• Owner: Zeryther
• License: mit
• Created: 2022-08-06T12:45:42.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-08-06T13:00:01.000Z (over 2 years ago)
• Last Synced: 2023-08-14T06:12:15.436Z (over 1 year ago)
• Topics: api, docker, jellyfin, mkv, python, subtitles
• Language: Python
• Homepage:
• Size: 3.91 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# jellyfin-extract-subtitles-docker

This script lets you manually extract subtitles from Jellyfin movies and episodes. The reason for this script existing is that Jellyfin can often struggle with extraction which results in no subtitles being displayed at all.

The original script was written by [Ian Walton](https://github.com/iwalton3), which you can find [here](https://gist.github.com/iwalton3/f60f4741f561a742e6f8689a621c9824). You can find the original post about this script [here](https://www.reddit.com/r/jellyfin/comments/metzk6/subtitle_extraction_script/).

Since I don't like to manage Python installations on my system, I wrapped it in a Dockerfile so anybody can run it more easily.

## Requirements

The script interacts with the Jellyfin API so you can run it from any system that has access to your instance over the internet. You only need the following things:

* Your Jellyfin instance's base URL

* An admin user

    * More specifically, an API key for an admin user

* A system with Docker installed that has acess to your Jellyfin instance over the internet.

Personally, I have experienced issues when connecting through proxies like Cloudflare or nginx with this script, so you might want to connect to the instance with the port directly.

## Running the script

You can run the script with the following command:

```

docker run \

    --rm \

    -e URL='http://your-jellyfin-base-url.example.com' \

    -e API_KEY='Your Jellyfin Admin API Key' \

    zeryther/jellyfin-extract-subtitles-docker

```

The script can be very resource intensive and may take over a day to run initially. Once most of your library is extracted, you can setup a cronjob for it if you wish. You can read more about it on the original post of the script [here](https://www.reddit.com/r/jellyfin/comments/metzk6/subtitle_extraction_script/).