psn_monitor

Powerful tool for real-time monitoring of Sony PlayStation (PSN) players' activities.

🚀 Quick Install & Run

New to Python or unsure what is installed? Follow the Python install walkthrough first.

Install from PyPI:

pip install psn_monitor

Run the setup wizard:

psn_monitor --setup

The wizard asks for the target, the npsso code and optional notifications. Review the settings before saving them. See Setup & First Run for how to get the npsso code and the required privacy settings.

For the manual single-file method, dependencies and upgrade commands, see Installation.

Features

🔍 Activity Tracking

• Gaming activity: Detect online and offline status, game starts, finishes and changes.
• Session statistics: Measure time in each state, time per game and games played.
• Session continuity: Preserve statistics through short offline interruptions.

📊 Profile Insights

• Profile details: View PSN IDs, status, platform, PS+ membership, bio, languages and friendship details.
• Recent games: See recently played titles, last played dates and total playtime.
• Optional trophies: Include a trophy summary and recently earned trophies.

🔔 Notifications and History

• Event alerts: Configure email, Discord and ntfy notifications independently.
• CSV history: Save reported activity with timestamps.
• Saved status: Resume monitoring with state retained across restarts.

⚙️ Setup and Configuration

• Guided setup: Configure a target, credentials and alerts with --setup, then check them with --doctor.
• Flexible settings: Use config files, dotenv files, environment variables and command-line options.
• Terminal and runtime controls: Customize colours and adjust the running monitor through supported signals.