Game Thumbs

Game Thumbs is an optional external service by @sethwv for sports matchup thumbnail and logo generation.

Teamarr templates can use Game Thumbs URLs in artwork fields to display matchup images with team logos.

Setting it up

Set the host once in EPG → Output → Game Thumbs → Game-Thumbs Base URL (e.g. https://game-thumbs.swvn.io or a self-hosted http://<host>:<port>), and keep slash-less relative paths in your templates:

{league_id}/{away_team|pascal}/{home_team|pascal}/cover.png?style=6&logo=true

The full path-joining rules (what counts as relative, why paths must not start with /, filters, URL-encoding) are in Artwork & Game Thumbs — they apply identically here.

The base URL is applied uniformly to all three art sinks — the EPG <icon>, the Dispatcharr channel logo, and filler art — so guide artwork and channel logos always match. Prefixing is idempotent and self-repairing: applying it twice never double-prefixes, and older values corrupted into /https://… form are fixed automatically.

Tennis doubles

Game Thumbs addresses a doubles pair with a + between the two players (/wta/haverlag+radisic/fernandez+tjen/logo.png). Providers publish a doubles side as a single /-joined name, and the pascal/slug filters preserve that pairing as +, so the shipped art paths compose both players per side with no template changes. Without the separator Game Thumbs matches the joined string to a single athlete and renders one player per side.

Conventions the starter templates use

The shipped starter templates use these Game Thumbs query parameters:

style=1 for team-channel covers, style=6 for event matchup covers
logo=true to include team logos, fallback=true to serve a generic image when a team is unknown
a badge= overlay parameter on event channel logos

Resources

Documentation: game-thumbs-docs.swvn.io
GitHub: github.com/sethwv/game-thumbs

Options

Hosted Instances

URL	User
`https://game-thumbs.swvn.io`	@sethwv

Hosted instances are community-provided and may have usage limits.

Self-Hosting

See the GitHub repository for self-hosting instructions.