PlayStation Network Smart-Home-Integration, kostenlos und Open Source

Verfolge PSN-Präsenz, Spiele, Spielzeit, Trophäen und deine PS4/PS5-Konsolen.
Verfolge in Gladys, wer auf der PlayStation spielt, welches Spiel, wie lange heute, die Trophäen deines Kontos und ob deine PS4 oder PS5 an, im Ruhemodus oder aus ist.
Inoffizielle Integration, nicht mit Sony verbunden. Sony bietet keine öffentliche API: Die Integration liest dieselben Daten wie die PlayStation App.
Bevor du beginnst
Du brauchst:
- ein PlayStation-Network-Konto (dessen Spiele und Trophäen du verfolgen willst);
- einen Computer mit Webbrowser, um einmal das NPSSO-Token abzurufen;
- für die Konsolen (optional): eine PS4 oder PS5 im selben Netzwerk wie Gladys.
Dein NPSSO-Token abrufen
Das NPSSO ist ein 64-stelliger Code, der beweist, dass du bei deinem Sony-Konto angemeldet bist. Die Integration meldet sich damit an, wie es die PlayStation App tut.
- Gehe im Browser auf playstation.com und melde dich mit deinem PlayStation-Network-Konto an.
- Öffne im selben Browser https://ca.account.sony.com/api/v1/ssocookie.
- Die Seite zeigt etwas wie
{"npsso":"Ab12...xyz"}. Kopiere den 64-stelligen Wert zwischen den Anführungszeichen (die ganze Zeile zu kopieren geht auch: Die Integration findet den Wert).
Zeigt die Seite einen Fehler, bist du nicht angemeldet: Zurück zu Schritt 1.
Halte dieses Token geheim. Wer es besitzt, kann dein Konto nutzen. Gladys speichert es in einem geheimen Feld, und die Integration schreibt es nie auf die Festplatte oder in die Logs. Wenn du glaubst, dass es durchgesickert ist, melde in den Einstellungen deines PlayStation-Kontos alle Geräte ab und hole ein neues.
Das Token gilt etwa zwei Monate. Läuft es ab, sagt es der Konfigurationsbildschirm der Integration: Hole auf dieselbe Weise ein neues und füge es ein.
Konfiguration
- Öffne den Tab Konfiguration der Integration.
- Füge das Token in NPSSO-Token ein.
- Zu verfolgende Freunde (optional): ihre Online-IDs, durch Kommas getrennt, höchstens 10. Ihre Privatsphäre-Einstellungen müssen dir ihren Online-Status zeigen.
- IP-Adresse der Konsole (optional): nur wenn „Meine Konsolen finden“ deine Konsole nicht findet (siehe unten).
- Aktualisierungsintervall: wie oft das PlayStation Network gelesen wird, standardmäßig 120 Sekunden (mindestens 60: Sony begrenzt die Anzahl der Anfragen).
- Zeitzone: „Heute gespielt“ beginnt um Mitternacht in dieser Zeitzone wieder bei null
(standardmäßig
Europe/Paris). - Speichere und klicke auf Verbindung testen: Sie zeigt deine Online-ID, deinen Status, deine Trophäen und den Status jedes Freundes.
- Öffne den Tab Erkennung und füge die gewünschten Geräte hinzu.
Die Geräte
Dein PSN-Konto
Die Funktionen kommen mit ihrem englischen Namen in Gladys an (unten in Klammern): Du kannst sie beim Hinzufügen des Geräts umbenennen.
| Funktion | Wert |
|---|---|
| Online (Online) | 1, wenn online an einer Konsole, sonst 0 |
| Im Spiel (In game) | 1, wenn ein Spiel läuft |
| Aktuelles Spiel (Current game) | der Name des Spiels, - wenn keines |
| Plattform (Platform) | PS5, PS4… |
| Aktuelle Sitzung (Current session) | Minuten seit dem Start des aktuellen Spiels |
| Heute gespielt (Played today) | Spielminuten seit Mitternacht |
| Trophäenstufe (Trophy level) | deine Trophäenstufe |
| Trophäen | Anzahl der Platin-, Gold-, Silber- und Bronzetrophäen |
Die Trophäen werden alle 15 Minuten und am Ende jedes Spiels gelesen.
Freunde
Jeder verfolgte Freund ist ein Gerät mit denselben Funktionen wie dein Konto, außer den Trophäen.
Konsolen
Jede gefundene Konsole ist ein Gerät mit einer Funktion Strom (Power): 1 wenn an, 0 im Ruhemodus oder aus.
Konsolen im lokalen Netzwerk
Eine PS4 oder PS5 meldet im lokalen Netzwerk, ob sie an oder im Ruhemodus ist. Dafür:
- PS5: Einstellungen → System → Energiesparen → Im Ruhemodus verfügbare Funktionen → aktiviere Mit dem Internet verbunden bleiben und Einschalten der PS5 über das Netzwerk aktivieren;
- PS4: Einstellungen → Energiespareinstellungen → Im Ruhemodus verfügbare Funktionen festlegen → aktiviere Mit dem Internet verbunden bleiben und Einschalten des PS4-Systems über das Netzwerk aktivieren.
Klicke dann in der Konfiguration auf Meine Konsolen finden: Gladys sendet die PlayStation-Suchanfrage in dein Netzwerk und listet auf, was geantwortet hat. Öffne den Tab Erkennung, um die Konsole hinzuzufügen.
Antwortet nichts (anderes Netzwerk, Router filtert Broadcasts), gib deiner Konsole im Router eine feste IP-Adresse, trage sie unter IP-Adresse der Konsole ein und klicke erneut auf Meine Konsolen finden.
Lokal oder Cloud
Gladys zeigt auf der Konsole ein Abzeichen lokal oder Cloud:
- lokal: Der Status kommt von der Konsole selbst, in deinem Netzwerk;
- Cloud: Der Status kommt von deiner PSN-Präsenz (online auf derselben Plattform = an).
Der Schalter Lokale Verbindung bevorzugen der Konfiguration wählt, was zuerst kommt. Sagt der bevorzugte Kanal nichts, wird der andere genutzt, und das Abzeichen zeigt einen orangen Punkt mit dem Grund. Ohne lokales Netzwerk lassen sich Ruhemodus und aus nicht unterscheiden, und eine von einem anderen Konto genutzte Konsole gilt als aus.
Die Integration kann eine Konsole weder einschalten noch steuern: Sie liest nur ihren Status.
Szenen
Auslöser
- Ein Spiel wurde gestartet: Dein Konto oder ein verfolgter Freund hat ein Spiel gestartet. Variablen: Online-ID, Spiel, Titel-ID, Plattform.
- Ein Spiel wurde beendet: Das Spiel endete oder ein anderes hat es ersetzt. Dieselben Variablen, plus die Sitzungsdauer in Minuten.
- Eine Trophäe wurde verdient: Dein Konto hat neue Trophäen verdient. Filter nach Stufe (Platin, Gold, Silber, Bronze). Variablen: Stufe, Anzahl neuer Trophäen, Gesamt dieser Stufe, Trophäenstufe.
Die Gerätefunktionen funktionieren auch mit den Standardauslösern von Gladys. Beispiele:
- wenn „Played today“ des Kontos meines Sohnes über 120 steigt, schicke mir eine Nachricht;
- wenn „Power“ der PS5 nach 22 Uhr auf 1 geht, schalte das Licht im Wohnzimmer aus.
Aktionen
- Status eines Spielers abrufen: liest jetzt das PlayStation Network und gibt online, im Spiel, Spiel, Plattform, aktuelle Sitzung und heute gespielt zurück, für die folgenden Aktionen der Szene (z. B. eine Bedingung „nur wenn im Spiel“).
- Status einer Konsole abrufen: an, Ruhemodus (
standby) oder aus, jetzt gelesen.
Dashboard-Widget
Füge das Widget PlayStation Network einem Dashboard hinzu. Es zeigt:
- die heute gespielte Zeit und die aktuelle Sitzung, und für dein Konto die Trophäenstufe und die Anzahl der Platintrophäen;
- wer was spielt, mit den Spielsymbolen (oder das Symbol deines Spiels, wenn du keinem Freund folgst);
- deinen Status, Plattform und Spiel sowie den Status der Konsolen;
- eine Schaltfläche Aktualisieren.
In den Widget-Einstellungen wählt Spieler, wessen Karte es ist (standardmäßig dein Konto).
Fehlerbehebung
- „Das NPSSO-Token ist abgelaufen oder falsch“: Hole ein neues (siehe oben). Das passiert auch nach einer Passwortänderung oder dem Abmelden aller Geräte.
- „Zu viele Anfragen an das PlayStation Network“: Erhöhe das Aktualisierungsintervall.
- Ein Freund ist „verborgen“: Seine Privatsphäre-Einstellungen zeigen dir seinen Status nicht, oder ihr seid keine Freunde mehr.
- Ein Freund hat „kein Konto mit diesem Namen“: Prüfe die Online-ID (Buchstaben, Ziffern,
-und_, 3 bis 16 Zeichen). - Die Konsole wird nicht gefunden: Prüfe die Energiespareinstellungen oben und dass sie eingesteckt ist (ganz ausgeschaltet antwortet sie nie).
- „Heute gespielt“ scheint niedrig: Die Zeit wird zwischen zwei Aktualisierungen gezählt. Waren Gladys oder das PlayStation Network lange nicht erreichbar, wird für die Lücke höchstens das Doppelte des Aktualisierungsintervalls gezählt.
Konfigurationseinstellungen
Diese Einstellungen fragt PlayStation Network in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Sony bietet keine öffentliche API: Die Integration meldet sich wie die PlayStation App mit einem NPSSO-Token an. 1) Melde dich auf playstation.com mit deinem Konto an. 2) Öffne im selben Browser den Link „Mein NPSSO abrufen“ unten. 3) Kopiere den 64-stelligen Wert von „npsso“ (oder die ganze Seite) und füge ihn unten ein. Das Token ist ein Schlüssel zu deinem Konto: Halte es geheim. Es gilt etwa zwei Monate; die Integration sagt dir, wann es erneuert werden muss. |
| NPSSO-Token | secret | Ja | Der 64-stellige Wert, den die Seite „Mein NPSSO abrufen“ anzeigt. |
| Zu verfolgende Freunde | string | Nein | Online-IDs durch Kommas getrennt, höchstens 10. Jede wird ein Gerät mit Präsenz und aktuellem Spiel (die Privatsphäre-Einstellungen müssen es erlauben). |
| Konsolen im lokalen Netzwerk | section | Nein | Eine PS4 oder PS5 meldet im lokalen Netzwerk, ob sie an oder im Ruhemodus ist, wenn „Mit dem Internet verbunden bleiben“ in den Energiespareinstellungen aktiv ist (PS5: auch „Einschalten der PS5 über das Netzwerk aktivieren“). Nutze „Meine Konsolen finden“ unten oder gib die IP-Adresse der Konsole ein, falls die Suche sie nicht findet. Ohne lokales Netzwerk folgt der Konsolenstatus deiner PSN-Präsenz. |
| IP-Adresse der Konsole (optional) | string | Nein | |
| Erweitert | section | Nein | |
| Aktualisierungsintervall (s) | number | Nein | Wie oft das PlayStation Network gelesen wird, in Sekunden (mindestens eine Minute: Sony begrenzt die Anzahl der Anfragen). |
| Zeitzone | string | Nein | „Heute gespielt“ beginnt um Mitternacht in dieser Zeitzone wieder bei null. |
So installierst du PlayStation Network in Gladys
- Öffne in Gladys Integrationen: PlayStation Network erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-playstationnetwork:0.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-playstationnetwork.
PlayStation Network benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
PlayStation Network ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation