No description
Find a file
Jose Falanga 2ed80ec8a1
All checks were successful
Build plugin / build (push) Successful in 1m6s
fix: critical bugs from code review
- Split get_boxart() into _enrich_metadata + _fetch_banner_textures (under 50 lines)
- Fix race condition: add _pending_gif_requests to prevent concurrent downloads
- Fix race condition: add is_instance_valid checks in _on_focus_changed
- Fix stale reference: check is_instance_valid on _focused_animated_texture
- Fix temp file collisions: use URL hash for unique temp file names
- Add timeout to HTTPRequest in _download_url_bytes (HTTP_TIMEOUT_MS was unused)
- Add bounds checks in _parse_gif_extension and _skip_gif_header for truncated GIFs
2026-08-19 21:31:57 -03:00
.forgejo/workflows Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00
assets Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00
core fix: critical bugs from code review 2026-08-19 21:31:57 -03:00
.gitignore Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00
export_presets.cfg Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00
LICENSE Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00
Makefile Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00
plugin.gd feat: animated GIF covers with config toggle and focus-based pausing 2026-08-19 21:11:04 -03:00
plugin.json feat: animated GIF covers with config toggle and focus-based pausing 2026-08-19 21:11:04 -03:00
README.md Initial commit: itch.io box art provider for OpenGamepadUI 2026-08-16 20:17:35 -03:00

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).