psntui 0.1.0__tar.gz

psntui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 psnTUI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

psntui-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: psntui
+Version: 0.1.0
+Summary: PSN Trophy Tracker TUI — sync and browse your PlayStation trophies from the terminal
+Author: TripShuti
+License: MIT
+Project-URL: Homepage, https://github.com/TripShuti/psnTUI
+Project-URL: Repository, https://github.com/TripShuti/psnTUI
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: psnawp>=3.0
+Requires-Dist: textual>=2.0
+Requires-Dist: platformdirs>=4.0
+Dynamic: license-file

psntui-0.1.0/README.md

@@ -0,0 +1,102 @@
+# psnTUI
+
+Terminal UI for browsing and syncing PlayStation trophies.
+
+## Features
+
+- **Sync trophies** from PSN — incremental, only fetches updated games
+- **Game library** — progress, trophy counts, last activity
+- **Trophy detail** — per-game list with rarity, earn rate, earned date
+- **Activity heatmap** — 11-week view, click any day to see trophies earned
+- **Month comparison** — current vs previous month
+- **Rarity distribution** — ultra rare / very rare / rare / common breakdown
+- **Play time tracking** — total, today, week, month per game (PS4/PS5 only)
+- **Headless sync** — optional scheduled sync via systemd or Windows Task Scheduler
+
+## Installation
+
+```bash
+pip install psntui
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/TripShuti/psnTUI
+cd psnTUI
+pip install .
+```
+
+## Usage
+
+### First run
+
+```bash
+psntui
+```
+
+Press `a` to authenticate, enter your NPSSO token (64-char code from
+PlayStation), then press `s` to validate and save.
+
+### Getting your NPSSO token
+
+1. Log in to https://ca.account.sony.com
+2. Open DevTools → Application → Cookies or go to https://ca.account.sony.com/api/v1/ssocookie
+3. Copy the value of `npsso`
+
+### Controls
+
+| Key | Action |
+|-----|--------|
+| `r` | Sync trophies from PSN |
+| `a` | Auth screen |
+| `f` | Search game |
+| `q` | Quit |
+| `Esc` | Back (from game detail) |
+| Click | Select game / trophies / heatmap day |
+
+### Headless sync (Linux — systemd)
+
+```bash
+bash systemd/install.sh
+```
+
+Installs a timer that syncs every 4 hours (15 min after boot).
+
+Manual trigger on any platform:
+
+```bash
+psntui --sync
+```
+
+### Headless sync (Windows — Task Scheduler)
+
+Run `psntui --sync` manually or create a scheduled task:
+
+```powershell
+# Run once
+psntui --sync
+
+# Create a task that runs every 4 hours
+$action = New-ScheduledTaskAction -Execute "psntui" -Argument "--sync"
+$trigger = New-ScheduledTaskTrigger -RepetitionInterval (New-TimeSpan -Hours 4) -AtStartup
+Register-ScheduledTask -TaskName "psnTUI Sync" -Action $action -Trigger $trigger -RunLevel Highest
+```
+
+## Data
+
+- **Linux:** `~/.config/psntui/`
+- **Windows:** `%APPDATA%\psntui\`
+- **macOS:** `~/Library/Application Support/psntui/`
+- SQLite database with WAL mode
+
+## Requirements
+
+- Python ≥ 3.11
+- A terminal with Unicode and TrueColour support (Windows Terminal, Windows Console Host with Virtual Terminal enabled, or any modern terminal on Linux/macOS)
+- PlayStation Network account with games on PS4/PS5
+- NPSSO token from PSN
+
+## License
+
+MIT

psntui-0.1.0/psntui/auth.py

@@ -0,0 +1,44 @@
+import json
+from pathlib import Path
+from platformdirs import user_config_dir
+
+
+APP_DIR = Path(user_config_dir("psntui", ensure_exists=True))
+CONFIG_PATH = APP_DIR / "config.json"
+DB_PATH = APP_DIR / "trophies.db"
+
+
+def get_config_path() -> Path:
+    return CONFIG_PATH
+
+
+def get_db_path() -> Path:
+    return DB_PATH
+
+
+def load_config() -> dict:
+    if CONFIG_PATH.exists():
+        return json.loads(CONFIG_PATH.read_text())
+    return {}
+
+
+def save_config(config: dict) -> None:
+    CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
+    CONFIG_PATH.write_text(json.dumps(config, indent=2))
+    CONFIG_PATH.chmod(0o600)
+
+
+def is_authenticated() -> bool:
+    config = load_config()
+    return bool(config.get("npsso"))
+
+
+def validate_npsso(npsso: str) -> str | None:
+    from psnawp_api import PSNAWP
+    try:
+        psnawp = PSNAWP(npsso_cookie=npsso)
+        client = psnawp.me()
+        online_id = client.online_id
+        return online_id
+    except Exception:
+        return None

psntui-0.1.0/psntui/cli.py

@@ -0,0 +1,66 @@
+import argparse
+import sys
+
+
+def headless_sync():
+    from . import auth, db, sync
+
+    config = auth.load_config()
+    if not config.get("npsso"):
+        print("Error: Not authenticated. Run 'psntui' and use the auth screen.")
+        sys.exit(1)
+
+    db.set_db_path(auth.get_db_path())
+    db.init_db()
+
+    online_id = config.get("online_id", "unknown")
+    print(f"Syncing trophies for {online_id}...")
+
+    def on_progress(current, total, name):
+        if total > 0:
+            pct = int((current / total) * 100)
+            print(f"  [{pct:3d}%] ({current+1}/{total}) {name}", end="\r")
+        else:
+            print(f"  ({current+1}) {name}", end="\r")
+
+    result = sync.sync_trophies(config["npsso"], progress_callback=on_progress)
+    print()
+
+    if result["status"] == "error":
+        print(f"Sync failed: {result['error']}")
+        sys.exit(1)
+    print(f"Done: +{result['trophies_added']} trophies, {result['games_updated']} games updated")
+    if result.get("warnings"):
+        for w in result["warnings"]:
+            print(f"  ⚠ {w}")
+    db.close_conn()
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="psntui",
+        description="PSN Trophy Tracker TUI",
+    )
+    parser.add_argument(
+        "--sync", action="store_true",
+        help="Run headless sync (for cron/systemd)",
+    )
+
+    args = parser.parse_args()
+
+    if args.sync:
+        headless_sync()
+        return
+
+    from . import auth, db
+    from .tui.app import psnTUI
+
+    db.set_db_path(auth.get_db_path())
+    db.init_db()
+
+    app = psnTUI()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

psntui-0.1.0/psntui/db.py

@@ -0,0 +1,384 @@
+import sqlite3
+from pathlib import Path
+from datetime import datetime, date, timedelta
+from typing import Optional
+import time
+import threading
+
+DB_PATH: Path | None = None
+
+_local = threading.local()
+
+
+_lock = threading.Lock()
+
+
+def set_db_path(path: Path) -> None:
+    global DB_PATH
+    with _lock:
+        DB_PATH = path
+
+
+def get_conn() -> sqlite3.Connection:
+    if DB_PATH is None:
+        raise RuntimeError("DB_PATH not set")
+    conn = getattr(_local, "conn", None)
+    if conn is not None:
+        try:
+            conn.execute("SELECT 1")
+            return conn
+        except (sqlite3.ProgrammingError, sqlite3.OperationalError):
+            try:
+                conn.close()
+            except sqlite3.Error:
+                pass
+    conn = sqlite3.connect(str(DB_PATH), timeout=15)
+    conn.row_factory = sqlite3.Row
+    conn.execute("PRAGMA busy_timeout=10000")
+    conn.execute("PRAGMA journal_mode=WAL")
+    conn.execute("PRAGMA foreign_keys=ON")
+    _local.conn = conn
+    return conn
+
+
+def close_conn() -> None:
+    conn = getattr(_local, "conn", None)
+    if conn is not None:
+        try:
+            conn.close()
+        except sqlite3.Error:
+            pass
+        _local.conn = None
+
+
+SCHEMA = """
+CREATE TABLE IF NOT EXISTS games (
+    np_communication_id TEXT PRIMARY KEY,
+    np_title_id TEXT,
+    title_name TEXT NOT NULL,
+    title_icon_url TEXT,
+    platform TEXT,
+    defined_bronze INTEGER DEFAULT 0,
+    defined_silver INTEGER DEFAULT 0,
+    defined_gold INTEGER DEFAULT 0,
+    defined_platinum INTEGER DEFAULT 0,
+    earned_bronze INTEGER DEFAULT 0,
+    earned_silver INTEGER DEFAULT 0,
+    earned_gold INTEGER DEFAULT 0,
+    earned_platinum INTEGER DEFAULT 0,
+    progress INTEGER DEFAULT 0,
+    last_updated_datetime TEXT,
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS trophies (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    np_communication_id TEXT NOT NULL,
+    trophy_id INTEGER NOT NULL,
+    trophy_name TEXT,
+    trophy_detail TEXT,
+    trophy_type TEXT,
+    trophy_icon_url TEXT,
+    trophy_hidden INTEGER DEFAULT 0,
+    trophy_group_id TEXT DEFAULT 'default',
+    earned INTEGER DEFAULT 0,
+    earned_date_time TEXT,
+    trophy_rarity TEXT,
+    trophy_earn_rate REAL,
+    progress INTEGER,
+    progress_rate INTEGER,
+    UNIQUE(np_communication_id, trophy_id),
+    FOREIGN KEY (np_communication_id) REFERENCES games(np_communication_id)
+);
+
+CREATE TABLE IF NOT EXISTS game_stats (
+    np_communication_id TEXT PRIMARY KEY,
+    title_id TEXT,
+    total_seconds INTEGER NOT NULL DEFAULT 0,
+    play_count INTEGER DEFAULT 0,
+    first_played TEXT,
+    last_played TEXT,
+    FOREIGN KEY (np_communication_id) REFERENCES games(np_communication_id)
+);
+
+CREATE TABLE IF NOT EXISTS play_delta_history (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    np_communication_id TEXT NOT NULL,
+    date TEXT NOT NULL,
+    delta_seconds INTEGER NOT NULL,
+    UNIQUE(np_communication_id, date),
+    FOREIGN KEY (np_communication_id) REFERENCES games(np_communication_id)
+);
+
+CREATE TABLE IF NOT EXISTS sync_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    started_at TEXT DEFAULT (datetime('now')),
+    finished_at TEXT,
+    status TEXT DEFAULT 'running',
+    error_message TEXT,
+    trophies_added INTEGER DEFAULT 0,
+    games_updated INTEGER DEFAULT 0
+);
+
+"""
+
+
+def init_db() -> None:
+    conn = get_conn()
+    try:
+        conn.execute("PRAGMA wal_checkpoint(TRUNCATE)")
+    except sqlite3.OperationalError:
+        pass
+    conn.executescript(SCHEMA)
+
+    conn.execute(
+        "DELETE FROM play_delta_history WHERE delta_seconds > 86400"
+    )
+
+    try:
+        conn.execute(
+            "UPDATE sync_log SET status = 'error', error_message = 'Cancelled (stuck)',"
+            " finished_at = datetime('now') WHERE status = 'running'"
+        )
+        conn.commit()
+    except sqlite3.OperationalError:
+        conn.rollback()
+
+
+def upsert_game(conn: sqlite3.Connection, g: dict) -> None:
+    conn.execute("""
+        INSERT INTO games (
+            np_communication_id, np_title_id, title_name, title_icon_url, platform,
+            defined_bronze, defined_silver, defined_gold, defined_platinum,
+            earned_bronze, earned_silver, earned_gold, earned_platinum,
+            progress, last_updated_datetime, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))
+        ON CONFLICT(np_communication_id) DO UPDATE SET
+            np_title_id=excluded.np_title_id, title_name=excluded.title_name,
+            title_icon_url=excluded.title_icon_url, platform=excluded.platform,
+            defined_bronze=excluded.defined_bronze, defined_silver=excluded.defined_silver,
+            defined_gold=excluded.defined_gold, defined_platinum=excluded.defined_platinum,
+            earned_bronze=excluded.earned_bronze, earned_silver=excluded.earned_silver,
+            earned_gold=excluded.earned_gold, earned_platinum=excluded.earned_platinum,
+            progress=excluded.progress, last_updated_datetime=excluded.last_updated_datetime,
+            updated_at=excluded.updated_at
+    """, (
+        g["np_communication_id"], g.get("np_title_id"), g["title_name"],
+        g.get("title_icon_url"), g.get("platform"),
+        g.get("defined_bronze", 0), g.get("defined_silver", 0),
+        g.get("defined_gold", 0), g.get("defined_platinum", 0),
+        g.get("earned_bronze", 0), g.get("earned_silver", 0),
+        g.get("earned_gold", 0), g.get("earned_platinum", 0),
+        g.get("progress", 0), g.get("last_updated_datetime"),
+    ))
+
+
+def upsert_trophy(conn: sqlite3.Connection, t: dict) -> None:
+    conn.execute("""
+        INSERT INTO trophies (
+            np_communication_id, trophy_id, trophy_name, trophy_detail,
+            trophy_type, trophy_icon_url, trophy_hidden, trophy_group_id,
+            earned, earned_date_time, trophy_rarity, trophy_earn_rate,
+            progress, progress_rate
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(np_communication_id, trophy_id) DO UPDATE SET
+            trophy_name=excluded.trophy_name, trophy_detail=excluded.trophy_detail,
+            trophy_type=excluded.trophy_type, trophy_icon_url=excluded.trophy_icon_url,
+            trophy_hidden=excluded.trophy_hidden,
+            earned=excluded.earned, earned_date_time=excluded.earned_date_time,
+            trophy_rarity=excluded.trophy_rarity, trophy_earn_rate=excluded.trophy_earn_rate,
+            progress=excluded.progress, progress_rate=excluded.progress_rate
+    """, (
+        t["np_communication_id"], t["trophy_id"], t.get("trophy_name"),
+        t.get("trophy_detail"), t.get("trophy_type"), t.get("trophy_icon_url"),
+        int(t.get("trophy_hidden", False)), t.get("trophy_group_id", "default"),
+        int(t.get("earned", False)), t.get("earned_date_time"),
+        t.get("trophy_rarity"), t.get("trophy_earn_rate"),
+        t.get("progress"), t.get("progress_rate"),
+    ))
+
+
+def write_game_with_trophies(conn: sqlite3.Connection, game: dict, trophies: list[dict]) -> None:
+    upsert_game(conn, game)
+    for t in trophies:
+        upsert_trophy(conn, t)
+
+
+def start_sync(conn: sqlite3.Connection) -> int:
+    cur = conn.execute("INSERT INTO sync_log (started_at) VALUES (datetime('now'))")
+    return cur.lastrowid or 0
+
+
+def finish_sync(conn: sqlite3.Connection, sync_id: int, status: str, trophies_added: int = 0,
+                games_updated: int = 0, error_message: str | None = None) -> None:
+    conn.execute("""
+        UPDATE sync_log SET finished_at = datetime('now'), status = ?, trophies_added = ?,
+            games_updated = ?, error_message = ?
+        WHERE id = ?
+    """, (status, trophies_added, games_updated, error_message, sync_id))
+
+
+def get_last_sync_time(conn: sqlite3.Connection) -> datetime | None:
+    row = conn.execute(
+        "SELECT started_at FROM sync_log WHERE status = 'success' ORDER BY started_at DESC LIMIT 1"
+    ).fetchone()
+    if row:
+        return datetime.fromisoformat(row["started_at"])
+    return None
+
+
+def game_exists(conn: sqlite3.Connection, np_comm_id: str) -> bool:
+    row = conn.execute(
+        "SELECT 1 FROM games WHERE np_communication_id = ?", (np_comm_id,)
+    ).fetchone()
+    return row is not None
+
+
+def get_games(conn: sqlite3.Connection) -> list[sqlite3.Row]:
+    return conn.execute(
+        "SELECT * FROM games ORDER BY title_name COLLATE NOCASE"
+    ).fetchall()
+
+
+def get_game_stats(conn: sqlite3.Connection, np_comm_id: str) -> sqlite3.Row | None:
+    return conn.execute(
+        "SELECT * FROM game_stats WHERE np_communication_id = ?", (np_comm_id,)
+    ).fetchone()
+
+
+def update_game_stats(conn: sqlite3.Connection, np_comm_id: str,
+                      title_id: str | None,
+                      total_seconds: int,
+                      play_count: int | None,
+                      first_played: str | None,
+                      last_played: str | None) -> None:
+    old = conn.execute(
+        "SELECT total_seconds FROM game_stats WHERE np_communication_id = ?",
+        (np_comm_id,)
+    ).fetchone()
+
+    conn.execute("""
+        INSERT OR REPLACE INTO game_stats
+            (np_communication_id, title_id, total_seconds, play_count, first_played, last_played)
+        VALUES (?, ?, ?, ?, ?, ?)
+    """, (np_comm_id, title_id, total_seconds, play_count or 0,
+          first_played, last_played))
+
+    if old is not None:
+        delta = total_seconds - old["total_seconds"]
+        if delta > 0:
+            today = date.today().isoformat()
+            conn.execute("""
+                INSERT INTO play_delta_history (np_communication_id, date, delta_seconds)
+                VALUES (?, ?, ?)
+                ON CONFLICT(np_communication_id, date)
+                DO UPDATE SET delta_seconds = delta_seconds + excluded.delta_seconds
+            """, (np_comm_id, today, delta))
+
+
+def get_play_time(conn: sqlite3.Connection, np_comm_id: str,
+                  since: str, until: str) -> int:
+    row = conn.execute("""
+        SELECT COALESCE(SUM(delta_seconds), 0) as total
+        FROM play_delta_history
+        WHERE np_communication_id = ? AND date >= ? AND date <= ?
+    """, (np_comm_id, since, until)).fetchone()
+    return row["total"] if row else 0
+
+
+def get_game(conn: sqlite3.Connection, np_comm_id: str) -> sqlite3.Row | None:
+    return conn.execute(
+        "SELECT * FROM games WHERE np_communication_id = ?", (np_comm_id,)
+    ).fetchone()
+
+
+def get_trophies(conn: sqlite3.Connection, np_comm_id: str) -> list[sqlite3.Row]:
+    return conn.execute(
+        "SELECT * FROM trophies WHERE np_communication_id = ? ORDER BY trophy_id",
+        (np_comm_id,)
+    ).fetchall()
+
+
+def get_recent_earned(conn: sqlite3.Connection, limit: int = 10) -> list[sqlite3.Row]:
+    return conn.execute("""
+        SELECT t.*, g.title_name, g.title_icon_url
+        FROM trophies t
+        JOIN games g ON g.np_communication_id = t.np_communication_id
+        WHERE t.earned = 1 AND t.earned_date_time IS NOT NULL
+        ORDER BY t.earned_date_time DESC
+        LIMIT ?
+    """, (limit,)).fetchall()
+
+
+def get_trophy_summary(conn: sqlite3.Connection) -> dict:
+    row = conn.execute("""
+        SELECT
+            COUNT(DISTINCT np_communication_id) as total_games,
+            SUM(CASE WHEN earned = 1 THEN 1 ELSE 0 END) as total_earned,
+            COUNT(*) as total_trophies,
+            SUM(CASE WHEN trophy_type = 'platinum' AND earned = 1 THEN 1 ELSE 0 END) as platinum,
+            SUM(CASE WHEN trophy_type = 'gold' AND earned = 1 THEN 1 ELSE 0 END) as gold,
+            SUM(CASE WHEN trophy_type = 'silver' AND earned = 1 THEN 1 ELSE 0 END) as silver,
+            SUM(CASE WHEN trophy_type = 'bronze' AND earned = 1 THEN 1 ELSE 0 END) as bronze
+        FROM trophies
+    """).fetchone()
+    return dict(row) if row else {}
+
+
+def get_earned_by_date_range(conn: sqlite3.Connection, since: str, until: str) -> list[sqlite3.Row]:
+    return conn.execute("""
+        SELECT DATE(earned_date_time) as day, COUNT(*) as count
+        FROM trophies
+        WHERE earned = 1 AND earned_date_time >= ? AND earned_date_time < ?
+        GROUP BY DATE(earned_date_time)
+        ORDER BY day
+    """, (since, until)).fetchall()
+
+
+def get_trophies_by_date(conn: sqlite3.Connection, date_str: str) -> list[sqlite3.Row]:
+    return conn.execute("""
+        SELECT t.*, g.title_name
+        FROM trophies t
+        JOIN games g ON g.np_communication_id = t.np_communication_id
+        WHERE t.earned = 1 AND DATE(t.earned_date_time) = ?
+        ORDER BY t.earned_date_time
+    """, (date_str,)).fetchall()
+
+
+def get_consecutive_days(conn: sqlite3.Connection) -> int:
+    rows = conn.execute("""
+        SELECT DISTINCT DATE(earned_date_time) as day
+        FROM trophies
+        WHERE earned = 1 AND earned_date_time IS NOT NULL
+        ORDER BY day DESC
+    """).fetchall()
+
+    if not rows:
+        return 0
+
+    streak = 0
+    expected = date.today()
+
+    for row in rows:
+        d = date.fromisoformat(row["day"])
+        if d == expected:
+            streak += 1
+            expected -= timedelta(days=1)
+        elif d < expected:
+            break
+        # skip future dates (shouldn't happen, but defensive)
+
+    return streak
+
+
+def get_earned_month(conn: sqlite3.Connection, year: int, month: int) -> int:
+    row = conn.execute("""
+        SELECT COUNT(*) as count FROM trophies
+        WHERE earned = 1
+            AND strftime('%Y', earned_date_time) = ?
+            AND strftime('%m', earned_date_time) = ?
+    """, (str(year), f"{month:02d}")).fetchone()
+    return row["count"] if row else 0
+
+