jose/itchio-opengamepadui-artprovider-plugin
1
0
Fork 0
Code Issues Pull requests Projects Releases 20 Packages Wiki Activity Actions
itchio-opengamepadui-artpro.../README.md
Jose Falanga cb26d9931c
All checks were successful
Build plugin / build (push) Successful in 1m10s
Details
Initial commit: itch.io box art provider for OpenGamepadUI
2026-08-16 20:17:35 -03:00

1.3 KiB
Raw Blame History

OpenGamepadUI itch.io Art Provider

Box art provider for itch.io games in OpenGamepadUI.

Fetches cover art and screenshots from itch.io game pages. Works alongside the itch.io library plugin to provide per-layout artwork: the cover for portrait/logo, full-res screenshots for landscape/banner.

Enriches game metadata by scraping the itch.io page HTML for screenshots (the itch.io API does not expose them), caches the result, and uses OGPU's HTTPImageFetcher for async image downloads.

Requirements

See the OpenGamepadUI requirements.

Building

make help
make build
make install

How it works

The provider registers with OGPU's BoxArtManager as "itch". When a menu requests artwork for a game, it checks the library item's launch items for one with _provider_id == "itch" and reads the itch.io game dict from its metadata (coverUrl, stillCoverUrl, url). It then:

  1. Looks up cached screenshots for the game (or scrapes the itch.io page).
  2. Picks the right URL for each layout:
    • portrait / logo: cover image
    • landscape: first screenshot (or cover if none)
    • banner: second screenshot (or first, or cover)
  3. Fetches the image via HTTPImageFetcher (with OGPU's Cache system).