From 5f6d29ee03bfd1f2085e89fe8883cf0edb516e74 Mon Sep 17 00:00:00 2001
From: tr4nt0r <4445816+tr4nt0r@users.noreply.github.com>
Date: Mon, 28 Jul 2025 03:40:44 +0200
Subject: [PATCH] Add friend tracking sensors to PlayStation Network

---
 .../playstation_network.markdown              | 26 +++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/source/_integrations/playstation_network.markdown b/source/_integrations/playstation_network.markdown
index 9793b39dcd07..dac26b9a0b8e 100644
--- a/source/_integrations/playstation_network.markdown
+++ b/source/_integrations/playstation_network.markdown
@@ -59,7 +59,7 @@ The **PlayStation Network** {% term integration %} lets you integrate informatio
 
 ### Sensors
 
-- **Online-ID**: Shows your PlayStation Network ID and current profile picture.
+- **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.
@@ -68,7 +68,8 @@ The **PlayStation Network** {% term integration %} lets you integrate informatio
 - **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.
@@ -77,6 +78,7 @@ The **PlayStation Network** {% term integration %} lets you integrate informatio
 
 - **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
 
@@ -85,10 +87,30 @@ You can send messages to a group using the `notify.send_message` {% term action
 
 For more information on using notifications, refer to the [Getting Started with Automation](/getting-started/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 {% my integration domain="playstation_network" title="**Settings** > **Devices & services** > **PlayStation Network**" %} and select **{% icon "mdi:plus" %} 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.