# orbisRPC — Discord Rich Presence for PS4 (GoldHEN RPC)
Discord Rich Presence for the jailbroken PS4 — every game, zero setup.
A background daemon that lives entirely on your console and posts what you're
playing to Discord: name, cover art, timer. No PC at runtime.
---
## Install (5 minutes)
1. Grab `OrbisRPC-Setup-1.1.0.pkg` from the
[Releases page](https://github.com/SirHumza/orbisRPC/releases/tag/v1.1.0)
and install it with Package Installer.
2. Open **orbisRPC Setup**. It stages `orbisrpc.bin` in
`/data/payloads`, writes `/data/orbisRPC/config.json`, retires any old
daemon, then asks for your Discord token.
3. Open **Payloads** in GoldHEN settings, go to `orbisrpc.bin`, press
**Square** to enable AutoRun, then **X** once to run it. Launch a
game, watch Discord.
After a reboot: it auto-runs on every jailbreak if you selected
AutoRun — no need to launch it again.
⚠️ Firmware note: currently tested on PS4 firmware 9.00. Other firmware
versions are supported by design (runtime capability probing, no hardcoded
offsets) but are not yet confirmed on hardware — please report results.
## What you get
| | |
|---|---|
| 🎮 **Any game, no lists** | Names resolve from your console's metadata (SFO, app.xml) plus Sony's TMDB — CUSA, PPSA, indies, zero per-game setup. |
| 🖼️ **Real cover art** | Game art served per title, PlayStation logo when idle. |
| ⏱️ **True timers** | Survive reconnects and restarts, resume across quick game switches. |
| 🧠 **Self-learning** | First-seen titles are remembered, so later boots resolve instantly. |
| 🔄 **Self-updating** | Daemon updates land from GitHub releases with automatic rollback. No reinstall treadmill. |
| 📦 **One-tap installer** | Setup PKG: install → token → payload in place. |
## How it works
```
PS4 (GoldHEN) Discord
┌─────────────────────────┐ ┌──────────────────┐
│ orbisRPC daemon │ TLS │ your profile │
│ sandbox scan → game ID │ ◄──► │ Playing Game │
│ metadata/TMDB → name │ │ [cover] [timer] │
└─────────────────────────┘ └──────────────────┘
```
Details: [`docs/DAEMON.md`](docs/DAEMON.md) · [`docs/INSTALLER.md`](docs/INSTALLER.md) ·
[`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) ·
[`docs/PRODUCTION.md`](docs/PRODUCTION.md)
## Config
Only `token` (your Discord user session token) is required —
`/data/orbisRPC/config.json`. Everything else ships working: presence text,
home art, poll interval, plus the self-learned `titles` map (hands off).
## Building
```bash
./scripts/build_sdk.sh # daemon payload (needs ps4-payload-sdk)
make -f installer/Makefile # Setup PKG (OpenOrbis toolchain, llvmshim)
make -C tests test # host unit tests
make -C tests asan # ASan/UBSan
python3 tests/e2e_consumer.py # contracts + linkage gate
```
## Safety
A user session token grants full account access — never share the config,
never commit a real token. Token-based presence is against Discord's ToS
(standard practice for headless presence tools; risk is yours).
## License
To be finalized (MIT vs GPL). No GPL source is copied into this tree.