mirror of
https://github.com/SirHumza/orbisRPC.git
synced 2026-10-06 12:00:39 +02:00
47 lines
1.9 KiB
Markdown
47 lines
1.9 KiB
Markdown
# 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)
|
|
|
|
## Path A: icon pack + external URLs (recommended)
|
|
|
|
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.
|