PlayStation Network
The PlayStation Network integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] enables you to seamlessly integrate information from your currently playing game in Home Assistant.
About PlayStation Network
PlayStation Network (PSN) is a digital media entertainment service provided by Sony Interactive Entertainment
How you can use this integration
The PlayStation Network integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you integrate information about your currently playing game into Home Assistant. You can display the game title and cover art in your Home Assistant dashboards.
Prerequisites
- To set up the PlayStation Network integration, you must first have an active PlayStation Network account. You can register for an account at the Official PlayStation® Site
. - During the setup process in Home Assistant, you will be asked to provide your NPSSO token. You will need to be logged into playstation.com
to access the token in your browser. You will find a link to retrieve the token in the config flow.
Configuration
To add the PlayStation Network service to your Home Assistant instance, use this My button:
PlayStation Network can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
Manual configuration steps
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select PlayStation Network.
-
Follow the instructions on screen to complete the setup.
Login to PlayStation Network
Supported functionality
Media players
- PlayStation Console: One Media Player will be created for any supported PlayStation console you have connected to the PlayStation Network. The artwork and title of the currently playing game will be populated.
Sensors
- Online ID: Shows your PlayStation Network ID and current profile picture.
- Trophy level: Displays your current PlayStation trophy level.
- Next Level: Shows your progress toward the next PlayStation trophy level as a percentage.
- Platinum trophies: Shows the total number of Platinum trophies you’ve earned. These are awarded for unlocking all other trophies in a game.
- Gold trophies: Displays your total count of Gold trophies, earned for major achievements within games.
- Silver trophies: Indicates the number of Silver trophies you’ve collected, typically for mid-level accomplishments.
- Bronze trophies: Shows how many Bronze trophies you’ve earned, usually for basic or early-game achievements.
- Last online: Displays the time when you were last seen online.
- Online status: Indicates your current availability on the PlayStation Network. Status options include Online, Offline, Away, and Online on PS App.
- Now playing: Shows the title of the game you are currently playing.
Binary sensors
- Subscribed to PlayStation Plus: Indicates if you have an active PlayStation Plus membership.
Image
- Avatar: Displays your current avatar.
- Share profile: Generates a QR code with a shareable link to your profile.
- Now playing: Displays the current game title image if you are playing a game.
Notifiers
The PlayStation Network integration creates a notify entity for each group you are a member of.
You can send messages to a group using the notify.send_message
actionActions are used in several places in Home Assistant. As part of a script or automation, actions define what is going to happen once a trigger is activated. In scripts, an action is called sequence. [Learn more].
For more information on using notifications, refer to the Getting Started with Automation page.
Track online status of friends
The PlayStation Network integration allows tracking the online status of your friends. To add a friend, go to Settings > Devices & services > PlayStation Network and select
After adding a friend, a new device will be created with the following entities:
Sensor
- Online ID: Shows the friend’s PlayStation Network ID with their current profile picture.
- Online status: Indicates the friend’s current availability on the PlayStation Network.
- Last online: Displays the time the friend was last seen online.
- Now playing: Shows the title of the game the friend is currently playing.
Image
- Avatar: Displays the friend’s current avatar.
- Now playing: Displays the current game title image if the friend is playing a game.
Data updates
This integration retrieves data from the PlayStation Network every 30 seconds to ensure timely updates.
Friend status updates occur every 180 seconds. If more than 20 friends are configured, the update interval will be gradually increased to avoid exceeding API rate limits.
Known limitations
PlayStation Network imposes a rate limit of 300 requests per 15 minutes.
This integration makes 3 requests per data update (every 30 seconds). This presently is well under the rate limit, but leaves room to add additional requests as the integration develops.
Please keep these limits in mind to avoid exceeding the PlayStation Network request allowance.
The Active state for each device is only reported via the API for the last used device. For example, if you start playing a game on your PS4 and without powering down, launch a game on your PS5, the API will only report your PS5 status.
Supported devices
The following devices are known to be supported by the integration:
- PlayStation 5
- PlayStation 4
- PlayStation 3
- PlayStation Vita
- PlayStation PC
Unsupported devices
The following devices are not supported by the integration:
- PlayStation Portable
- Other PlayStation system variants (PlayStation TV) or older systems that do not support the PlayStation Network
Use cases
You can display your currently playing game as artwork on your dashboard.
Remove integration
This integration can be removed by following these steps:
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three dots
menu. Then, select Delete.