Files
SirHumza--orbisRPC/deploy/ARTWORK.md
T

1.9 KiB

Cover art pipeline

Path A: Sony TMDB icon URLs (primary, fully automatic)

Every title lookup also queries Sony's TMDB service, which returns an official 512x512 icon URL on Sony's CDN. The daemon sends it as assets.large_image (Discord accepts external image URLs there). No uploads, no hosting, no per-game work, works on any console. If the service lacks the title or the network fails, the next path is tried.

Path B: icon pack + external URLs (fallback, maintainer-hosted)

The daemon sends assets.large_image as <art_base_url><lowercase titleId>.png (Discord accepts external image URLs in asset fields). Host the pack once, e.g. in this repo:

config/icons/cusa00740.png   (512x512 PNG, pulled from the console)

scripts/sync_icons.sh pulls every /user/appmeta/<TITLEID>/icon0.png off the PS4 over FTP (read-only) into config/icons/. Set art_base_url in config to the hosted prefix, e.g. https://raw.githubusercontent.com/<you>/orbisRPC/main/config/icons/. Every install then shows art with zero setup. Missing files degrade to no image. Pack hosting is a maintainer decision (game art is not ours).

Path B: shared Discord application (fallback)

Create an application, upload one PNG per game under Art Assets named as the lowercase title ID, set application_id in config. The daemon sends the asset key instead. Capped at 300 assets per app.

Current default: the public PS4-Rich-Presence-for-Discord application (zorua98741/bshar1865, ID 858345055966461973), which already hosts per-title art. Borrowed backend, credited here: if it ever goes away, art degrades to nothing and everything else keeps working. Replace the default with your own app ID to own the whole chain.

Runtime behavior

URL pack wins when art_base_url is set, uploaded keys when only application_id is set, no artwork otherwise (one log notice). Missing art never crashes anything.