pbalazs123/felirathub repository overview

⁠FeliratHUB

Hungarian & English subtitles for Stremio

Subtitles from SuperSubtitles⁠ (feliratok.eu) and OpenSubtitles in one list, for the right episode, with correct Hungarian accents, best match first.

GitHub⁠ • Releases⁠ • Report a bug⁠

⁠✨ Features

• 🔗 Two sources, one list: OpenSubtitles first; SuperSubtitles fills in the languages OpenSubtitles has nothing in, or nothing that matches your file at least 70%
• 🇭🇺 Hungarian and English subtitles, or only one of them
• 🔍 Right episode, right film: other episodes, seasons and same-name films are filtered out
• 📦 Season packs: the episode is taken out of ZIP and RAR packs on the fly
• 🔤 Correct accents: everything arrives as UTF-8, so ő and ű display correctly
• 🏆 Best match first: the best 2 per language (all of them when the player sends no file name), ranked by how well they fit what you play: the source and release group count most (and the cut for films), shown as e.g. "Magyar · 92%"
• 🎭 Forced subtitles: subtitles for the Hungarian dub ("szinkronoshoz") are listed as "Magyar · Forced", after the full ones
• 🎯 Configure page to choose languages and sources; install with one click
• 💾 History and disk cache in /data: mount a volume there and they survive restarts
• 📤 Your own subtitles: upload a subtitle on the dashboard for a film or episode; it is offered with the others as the source "Uploaded"
• 📊 Dashboard with sign-in (DASHBOARD_PASSWORD): request history, your uploads, source status, caches and system health
• 🔒 Hardened: non-root, no package managers in the image, zip-bomb and size limits

⁠🏷️ Tags

All images support linux/amd64 and linux/arm64 (e.g. Raspberry Pi 4/5). The same images are also on ghcr.io/pbalazs123/felirathub.

⁠🚀 Quick Start

⁠Docker Compose (recommended)

services:
  felirathub:
    image: pbalazs123/felirathub:latest       # or :dev for test builds
    container_name: felirathub
    restart: unless-stopped
    ports:
      # Only reachable from this host; put a reverse proxy with HTTPS in front of it.
      - "127.0.0.1:7000:7000"
    # Optional settings: remove the "#" in front of "environment:" and of the lines you need.
    # environment:
    #   DASHBOARD_PASSWORD: change-me          # enables the admin dashboard at /dashboard
    #   OPENSUBTITLES: "0"                     # OpenSubtitles off for new installs
    #   PUBLIC_URL: https://subs.example.com   # only if links come out with the wrong address
    volumes:
      - felirathub-data:/data                  # request history (SQLite) and disk cache survive restarts

volumes:
  felirathub-data:

docker compose up -d

The same file is in the repository: curl -O https://raw.githubusercontent.com/pbalazs123/felirathub/main/docker-compose.yml

⁠Docker Run

docker run -d \
  --name felirathub \
  --restart unless-stopped \
  -p 127.0.0.1:7000:7000 \
  -v felirathub-data:/data \
  pbalazs123/felirathub:latest

Then open http://localhost:7000/, choose your settings and click Install.

⁠🔐 HTTPS (required for remote access)

Stremio only accepts plain-HTTP addons from localhost. To use FeliratHUB from other devices, put it behind a reverse proxy with HTTPS. Example with Caddy:

subtitles.example.com {
	reverse_proxy 127.0.0.1:7000
}

If Caddy runs in Docker on the same network, use reverse_proxy felirathub:7000. Then install the addon from https://subtitles.example.com/configure.

⁠⚙️ Environment Variables

All optional.

⁠🔄 Updating

docker compose pull && docker compose up -d

⁠❓ Troubleshooting

• No subtitles? The title may have none in your languages, or a source or language is switched off on the configure page.
• See what's happening: run with -e DEBUG_SUBS=1 and check docker logs felirathub.

FeliratHUB is unofficial and not affiliated with SuperSubtitles, OpenSubtitles or Stremio.