# 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.0.0.pkg` from the
[Releases page](https://github.com/SirHumza/orbisRPC/releases/tag/v1.0.0)
and install it with Package Installer.
2. Open **orbisRPC Setup**. It stages `orbisrpc.bin` + `evict.elf` in
`/data/payloads`, writes `/data/orbisRPC/config.json`, evicts any old
daemon, then asks for your Discord token.
3. Launch **orbisrpc** from Payload Guest (GoldHEN's payload menu),
launch a game, watch Discord.
After a reboot: re-jailbreak, then enable AutoRun for `orbisrpc` in
Payload Guest once โ it starts itself on every jailbreak after that.
## 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.