Your subtitles deserve metadata. Sublogue adds it.
Sublogue is a lightweight open-source tool for enriching SRT files. Pull metadata from OMDb, TMDB, or TVMaze and automatically append plot summaries, runtimes, directors, and cast details to the start or end of your subtitles.
Why? If the cast and IMDb/RT rating appear in the first minute, movie night involves fewer questions and more watching!
## Features
- Insert plot summaries into existing .srt files without shifting timings
- Fetch metadata (plot, runtime, director, cast, IMDb/RT ratings) using OMDb, TMDb, and TVMaze โ add these integrations under Settings before scanning
- Preserve original dialogue and timing with safe insertion logic
- Clean, fast web UI for scanning and batch processing built with Svelte + Python/Flask
- Three themes included: OLED, Ocean, and Dracula White
## Screenshots
## Getting started
To get started installing Sublogue, expand on your posion below. Personally, I recommend Komodo. It's great.
โ Docker Compose
Create `data/` and `media/` folders next to the compose file, then run:
```yaml
version: "3.9"
services:
sublogue:
image: ghcr.io/ponzischeme89/sublogue:latest
container_name: sublogue
restart: unless-stopped
environment:
- TZ=Pacific/Auckland
volumes:
- ./data:/config
- ./media:/media
ports:
- "5000:5000"
```
Start the stack:
```bash
docker compose up -d
```
Open `http://localhost:5000`.
๐งก Unraid
Use the included template at `unraid-sublogue.xml`.
- `/mnt/user/appdata/sublogue` -> `/config`
- `/mnt/user/appdata/sublogue/media` -> `/media`
Start the container and open `http://:5000`.
๐ฆ Komodo
Create a new stack and paste a Komodo template like this:
```yaml
version: "3.9"
services:
sublogue:
image: ghcr.io/ponzischeme89/sublogue:latest
container_name: sublogue
ports:
- "5000:5000"
environment:
- TZ=Etc/UTC
- PUID=1000
- PGID=1000
volumes:
- /volume1/Docker/sublogue/data:/config
- /volume1/Media:/media
restart: unless-stopped
networks:
- npm_network
networks:
npm_network:
external: true
```
## Support
- Help spread the word about Sublogue by telling your friends about this repo
- Give the repo a star (This really helps)
