PongPlot 🏓

Realtime Network Route & Latency Monitor Web Dashboard.

⚡ Quick Start

1. Install globally

npm install -g pongplot

2. Start PongPlot

pongplot

That's it! PongPlot will automatically start the background server, open the web dashboard in your default browser at http://127.0.0.1:7465, and present an interactive manager menu in your terminal.

🎮 Interactive Manager Menu

When launched, PongPlot displays an interactive arrow-key terminal menu:

  ╔══════════════════════════════════════════════════════╗
  ║  PongPlot v1.0.0 — http://127.0.0.1:7465            ║
  ╚══════════════════════════════════════════════════════╝

  Select an option (Use ↑↓ arrows, Enter to select):
  ❯ 🌐 Open Dashboard in Browser
    🔽 Hide to System Tray
    🚀 Enable Auto-start on Boot
    ❌ Exit PongPlot

🚀 CLI Options

pongplot                  # Start with default settings (port 7465)
pongplot --port 8080      # Run on custom port
pongplot --host 0.0.0.0   # Bind to all network interfaces (LAN)
pongplot --tray           # Run directly in background system tray
pongplot --no-browser     # Don't open browser automatically
pongplot --skip-update    # Skip auto-update check
pongplot --help           # Show all available options
pongplot --version        # Show version

🛠️ Features

• ⚡ Realtime Route Monitor: Continuous multi-hop ICMP ping and traceroute.
• 📊 Interactive Web UI: Modern, clean dashboard with latency charts and hop metrics.
• 💾 Historical Data: SQLite-backed history tracking.
• 🔔 Instant Alerts: Latency spike and packet loss notifications.
• 🔽 System Tray Integration: Minimize to Windows tray with zero binary overhead.
• 🚀 Auto-start on Boot: Optional 1-click startup registration.
• 🔒 Security: Configurable allowlist, TLS certificate generation, and admin authentication.
• 🔄 Auto Port Resolution: Automatically clears stale processes before launching.
• 🌐 Zero Configuration: Works out-of-the-box on localhost.

📦 Run without installing (npx)

You can also run PongPlot directly without global installation:

npx pongplot

📄 License

MIT © pool-talent