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. It allows users to enjoy a variety of gaming-related services such as purchasing games, downloading content, and connecting with other players.

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.

  • Go to Settings > Devices & Services.

  • 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

NPSSO Token

Supply your NPSSO token after successfully logging into the PlayStationNetwork in your browser.

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 Add friend.

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

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.