PS5 Remote Play smart home integration, free and open source
Switch your PlayStation 5 on or to rest mode and see the game being played.
Published by LuckyS7evin
- Devices
- Version 1.0.0
- Requires Gladys >=5.1.0
- ★ 0
Control your PlayStation 5 from Gladys: power on, rest mode, console status and game being played, with scene triggers and a dashboard widget. The integration follows the Home Assistant add-on ps5-mqtt, without MQTT: it talks to the console directly with Sony's Remote Play protocol (through playactor).
PlayStation 4 consoles are supported too (power on, rest mode, running game) once the dedicated option is enabled.
Prepare the console
In the PS5 settings:
- System > Remote Play: turn on Enable Remote Play.
- System > Power Saving > Features Available in Rest Mode: turn on Stay Connected to the Internet and Enable Turning On PS5 from Network.
- The console must be on the same local network as Gladys (or reachable from Gladys, see Console IP addresses).
Without these settings, the console does not answer in rest mode or refuses the commands (403 error in the logs).
Add the console
- Switch the console on (not in rest mode).
- Open the Discovery tab of the integration: Gladys searches the local network for consoles. Add yours.
- If it does not show up (another VLAN, a router filtering broadcasts), type its IP address in Console IP addresses (several addresses separated by commas), save and run the discovery again.
Each console becomes a device with three features:
| Feature | Values |
|---|---|
| Power | 1 = on, 0 = rest mode or unreachable (controllable) |
| Status | playing, idle, standby or offline |
| Game | name of the game being played, - otherwise |
The state is read every 10 seconds.
Pair the console
To switch the console on or put it in rest mode, the integration must be paired with the console, like the PS Remote Play app. It is done once, with the two actions of the Configuration tab:
- Click 1. Get the PlayStation sign-in link. Open the link shown, sign in
with the PlayStation account used on the console. You land on a blank page
(or an error page): copy its full address from the address bar of the
browser. It starts with
https://remoteplay.dl.playstation.net/remoteplay/redirect?code=. - On the console, switched on, open Settings > System > Remote Play > Link Device: an 8-digit code shows up.
- Click 2. Pair a console, pick the console, paste the copied address and type the PIN. The message under the button confirms the pairing.
The copied address is only valid for a few minutes: if pairing fails, start again from step 1 with a new PIN.
If your PlayStation profile asks for a passcode at login, set it in Profile
passcode (digits, or key names separated by spaces, e.g. up up down down).
Game being played (optional)
The PS5 does not say what it runs. The game is read from the presence of your PlayStation Network account, with an NPSSO token:
- Sign in on playstation.com.
- In the same browser, open https://ca.account.sony.com/api/v1/ssocookie.
The page shows
{"npsso":"…"}: copy the 64-character value. - Paste it in NPSSO token and save.
- Click Test the PlayStation Network account to check it.
The NPSSO token expires after two months, but it is only used for the first
sign-in: the integration then keeps and refreshes its own tokens (in its
/data volume, readable by it only). If signing in fails, the Configuration
screen says so: generate a new NPSSO token.
The game is attached to the switched-on console matching the platform of the game. When several consoles are on, pick the Preferred console. The Game refresh interval (30 s by default, 10 s minimum) stays within the limit of Sony's API (300 requests per 15 minutes).
On a PS4, the running game comes from the console itself, no PSN account needed.
Scenes
- Use the Power feature of the console in the "Control a device" actions to switch the console on or put it in rest mode, and in the "Device state change" triggers to react when it is switched on.
- Game started (trigger): a game starts on a console. Optionally filter on
the console and the title ID (e.g.
PPSA01521_00). The following actions can read{{triggerEvent.data.title_name}}and{{triggerEvent.data.title_id}}. - Game stopped (trigger): the game is closed, the console is put in rest mode or is no longer reachable.
Example: "when a game starts on the living room PS5, dim the lights and turn the soundbar on".
Dashboard
Add the PlayStation widget and pick a console: it shows the live power state, the status, the game being played with its cover, and two buttons, Switch on and Rest mode.
Troubleshooting
- The console is not in the Discovery tab: check it is on or in rest mode with Stay Connected to the Internet, then type its IP address in the configuration.
- "not paired yet": pair the console (actions 1 and 2).
- 403 error: Remote Play is disabled on the console, or the pairing was removed: pair the console again.
- "passcode": set the profile passcode.
- The status stays
offline: the console is fully switched off (not in rest mode) or changed IP address; the integration searches again at most every 5 minutes. - The logs of the integration (Gladys Supervision page) detail every error.
Configuration settings
These are the settings PS5 Remote Play asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Getting started | section | No | On the console, enable Remote Play, and in the power saving settings keep it connected to the Internet and allow turning it on from the network. Then add the console from the Discovery tab and pair it with the two actions below. |
| Console IP addresses | string | No | Optional, comma-separated: consoles the network scan cannot find (another VLAN, broadcasts filtered). |
| Include PlayStation 4 consoles | boolean | No | PS4 consoles support power on, rest mode and the running game. |
| Profile passcode | secret | No | Only if the PlayStation profile asks for a passcode at login: digits, or key names separated by spaces. |
| Game being played (optional) | section | No | The console does not say what it runs: the game comes from the presence of your PlayStation Network account. Sign in on playstation.com, then open the NPSSO link below and copy the 64-character value of "npsso". |
| NPSSO token | secret | No | Only used to sign in: the tokens it yields are kept and refreshed by the integration. |
| Preferred console | select | No | When several consoles are on, the game is shown on this one. |
| Game refresh interval (s) | number | No | How often the PlayStation Network presence is read (10 s minimum, rate-limited by Sony). |
How to install PS5 Remote Play in Gladys
- In Gladys, open Integrations: PS5 Remote Play appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/luckys7evin/gladys-ps5-mqtt:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/LuckyS7evin/gladys-ps5-mqtt.
PS5 Remote Play requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
PS5 Remote Play is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by LuckyS7evin, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation