Poster Overlay Layer Integration Service for self-hosted poster overlays with ratings, genre lines, trend tags, and configurable artwork sources.

POLIS renders posters on demand from IMDb ids (WebP by default), then serves them through addon manifest and art URLs. Built for Aurora Media Center. Also works with AIOMetadata art patterns or any Stremio-compatible addon client.

Inspired by the Better Posters addon.

• Bun 1.3+
• TMDB API key
• MDBList API key

cp env.example .env
# Edit .env: TMDB_ACCESS_TOKEN or TMDB_API_KEY, POLIS_PUBLIC_URL

bun install
bun run dev

Open http://localhost:3050/configure to configure overlays and copy your install URL.

bun run build
bun run start

Default port: 3050 (override with -p on next start / next dev).

Poster routes return WebP by default (POLIS_POSTER_FORMAT / NEXT_PUBLIC_POLIS_POSTER_FORMAT in env.example).

cp env.example .env
# Set POLIS_PUBLIC_URL and TMDB keys in .env

docker compose up -d

Image: ghcr.io/crazycacti/polis:latest

compose.yaml mounts ./data to /app/data. The entrypoint creates that directory and the app creates polis.sqlite on first use.

Buy Me a Coffee

MIT. See LICENSE.