Alla soglia del 2026, chi esegue il jailbreak della PlayStation 5 non dovrà più accontentarsi di giocare offline: con PS5-Monitor-Hub la console si trasforma in un vero e proprio hub smart.
Questo strumento open-source, sviluppato in Python e disponibile anche come eseguibile pronto all’uso, si collega alla PS5 tramite rete locale e monitora in tempo reale informazioni essenziali come il titolo del gioco in corso, lo stato di accensione o sleep, la temperatura di CPU e SoC, la frequenza del clock e la durata della sessione di gioco, consentendo di inviarle ovunque l’utente desideri.
Le due caratteristiche principali rendono PS5-Monitor-Hub unico nel suo genere. La prima vede la perfetta integrazione con Discord Rich Presence, che mostra in tempo reale a tutti gli amici cosa si sta giocando, con copertine, artwork e timer live, senza necessità di overlay, OBS o bot complicati.
La seconda vede invece l’integrazione con Home Assistant tramite MQTT, che permette di trasformare la console in un vero centro smart della casa: le luci Philips Hue possono diventare rosse durante un boss fight, il termostato può abbassarsi se la PS5 supera i 70 °C, e molte altre automazioni sono possibili con pochi passaggi.
Avviso
Per visualizzare temperature e frequenze su Home Assistant OS (HAOS), installare AirPSX e attivarlo sulla PS5.
Funzionalità principali
- Architettura modulare: Estendi le funzionalità usando plugin Python (ad esempio dashboard web, registratore di sessioni).
- Discord Rich Presence: Mostra il gioco in corso, artwork e tempo di sessione.
- Integrazione Home Assistant (MQTT): Esporta stato, dettagli del gioco e telemetria hardware.
- Monitoraggio PS5 in tempo reale: Connessione a KLOG (porta 9081) per rilevamento immediato del Title ID.
- Telemetria hardware: Recupera statistiche interne di debug della PS5 come temperatura e frequenza di CPU/SoC.
- Dati di gioco e caching: Recupera dati di gioco e copertine con caching locale.
- GUI CustomTkinter: Interfaccia pulita e moderna con supporto al system tray.
- Auto Reconnect: Connessione robusta con meccanismi di recupero automatico.
Requisiti e installazione
- Il progetto utilizza librerie asincrone e richiede strumenti specifici per monitorare le statistiche.
Dipendenze
- Installare tutte le dipendenze con:
pip install -r requirements.txt
Oppure manualmente:
- customtkinter
- pystray
- Pillow
- pypresence
- paho-mqtt
- playwright
- beautifulsoup4
- httpx
- requests
Configurazione browser Playwright
- Richiesto per il recupero delle statistiche hardware:
playwright install chromium
Come funziona (Architettura Hub)
Monitor Core
- Connette alla PS5 KLOG per rilevare il Title ID.
- Connette al server di debug della PS5 per le statistiche hardware.
Event Broadcast
- Ogni cambiamento di stato attiva l’evento on_core_update.
Handlers
- DiscordHandler: Aggiorna Discord Rich Presence.
- HAOSHandler: Pubblica la telemetria via MQTT.
- I plugin ricevono automaticamente i dati in tempo reale.
Panoramica dei componenti
| Componente | Porta / Destinazione | Funzione |
|---|---|---|
| KLOG Monitor | 9081 | Rileva Title ID e stato di accensione |
| Stats Monitor | 1214 | Legge la telemetria hardware |
| Game Scraping | Web scraping | Recupera copertine e titoli dai server patch |
Configurazione e avvio
EXE già pronto
- È disponibile un EXE precompilato con PyInstaller nella sezione Releases del repository per un avvio immediato.
1. Configurazione iniziale
- Creare un’applicazione Discord e ottenere il Client ID.
- Assicurarsi che la PS5 abbia un IP LAN statico.
- Creare una cartella plugins per i moduli personalizzati.
2. Avvio
- Avviare con:
python main.py - In alternativa in modalità headless:
python main.py --nogui
3. Hot Reload
- Ricaricare i plugin istantaneamente tramite l’interfaccia GUI.
Panoramica GUI
- Tab Generale: Impostazioni IP PS5, ricarica plugin, log globali.
- Tab Discord / Home Assistant: Pannelli di configurazione dedicati.
- Tab Plugin Dinamici: Creati automaticamente per ogni plugin.
File di configurazione
| File | Funzione |
|---|---|
config.json | Impostazioni utente e configurazione plugin |
ps5_game_cache.json | Metadati di gioco memorizzati nella cache |
Creazione EXE (opzionale)
- Comando per creare l’EXE con PyInstaller:
pyinstaller --noconsole --onefile --clean --name "PS5 Monitor Hub" --icon=icon.ico main.py
Changelog
Questo è un aggiornamento fondamentale! Il progetto è passato da un semplice script Discord RPC a un vero e proprio PS5 Monitor Hub. Il motore principale è stato completamente rifattorizzato per supportare un sistema di plugin modulare, telemetria hardware e integrazioni con smart home.
Nuovo nome del progetto
- Il nome è cambiato in PS5-Monitor-Hub per riflettere queste capacità estese.
Nuove funzionalità
Sistema di plugin
- Architettura modulare: Ora è possibile aggiungere estensioni senza modificare il codice principale. Basta inserire file .py nella cartella /plugins.
- Hot Reload: Un pulsante “Reload Plugins” nella GUI permette di ricaricare i plugin all’istante senza riavviare l’applicazione.
- Plugin inclusi:
- Web Dashboard: Ospita un server web locale per mostrare stato e statistiche.
- Desktop Notify: Invia notifiche native di Windows quando cambia il gioco.
- CSV Logger: Registra le sessioni di gioco in un file CSV.
Telemetria hardware (Root/Debug)
- Connessione al server interno delle statistiche PS5 (porta 1214) usando Playwright.
- Visualizzazione di temperatura CPU, temperatura SoC e frequenza dentro:
- L’applicazione.
- Discord.
- Home Assistant.
Integrazione Home Assistant (HAOS)
- Supporto MQTT: Pubblicazione integrata dei dati di monitoraggio su Home Assistant.
- Sensori auto-generati: Stato della console, gioco corrente, immagine, sfondo e statistiche hardware.
Miglioramenti GUI e UX
- Tab dinamici: l’interfaccia genera automaticamente schede di configurazione per ogni plugin caricato.
- System Tray: possibilità di ridurre l’app nella barra di sistema per mantenere pulita la taskbar.
- Salvataggio intelligente: le impostazioni vengono salvate in modalità asincrona e i servizi si riavviano automaticamente al salvataggio.
- Rifinitura visiva: nuove icone e layout dell’interfaccia più pulito.
Modifiche tecniche e correzioni
- Architettura divisa in:
- app/core.
- app/discord.
- app/haos.
- app/plugin_manager.
- Risolto il blocco della UI spostando gli aggiornamenti di rete e Discord in thread daemon.
- Sistema browser portatile: le build EXE sono ora più leggere e i browser Playwright vengono caricati da una cartella locale.
- Nuovo ConfigManager robusto per gestione sicura dei valori predefiniti e configurazioni nidificate.
- Passaggio a httpx per uno scraping più veloce dei metadati dei giochi.
Come installare o aggiornare
Per utenti EXE (Windows)
- Scaricare
PS5_Status_Hub_v1.2_Windows.zip. - Estrarre tutti i file (il
.exee la cartella browsers devono rimanere insieme). - Eseguire:
PS5 Monitor Hub.exe.
Per utenti Python (sorgente)
- Scaricare le ultime modifiche:
git pull origin main - Aggiornare le dipendenze:
pip install -r requirements.txt - Installare i browser Playwright:
playwright install chromium - Eseguire l’applicazione:
python main.py
Download: PS5 Monitor Hub v1.2
Download: Source code PS5 Monitor Hub v1.2
