Find, score and clean ASS subtitles for anime

How to set it up

1. 01 Start the container with the file below and mount your anime folder.
2. 02 Under Settings → Scoring, apply the anime preset or pin it to the language profile of your anime library.
3. 03 Enable AniDB under Settings → Connections → Metadata, then switch on the cleanups you want — each one shows what it would touch first.

docker-compose.yml

One container, two volumes. Replace /path/to/media with your media folder and set PUID/PGID to your user (id prints them).

services:
  sublarr:
    image: ghcr.io/abrechen2/sublarr:1.20.0
    container_name: sublarr
    ports:
      - "5765:5765"
    volumes:
      - ./config:/config
      # your anime folder
      - /path/to/media:/media:rw
    environment:
      - PUID=1000
      - PGID=1000
    restart: unless-stopped

Start and check:

docker compose up -d
curl http://<host>:5765/api/v1/health

The answer contains {"status":"healthy","version":"…", …}

Limits

• ASS gets priority, not a monopoly: if an episode only has SRT, Sublarr takes the best SRT.
• How good ASS ends up looking is up to the player. Sublarr delivers the file with its styling — the client has to render it.
• AniDB resolution is most reliable with the AniDB cache enabled and current. Without it, the other tiers take over.
• Cleanups delete files — but only after the preview, and subtitles go to the trash for 30 days.

When it doesn't work