{"repo":"nr-yolo/netflow","free":true,"listed":false,"github":"https://github.com/nr-yolo/netflow","clone":"git clone https://github.com/nr-yolo/netflow.git","description":"Live packet flow visualizer — fetches from ntop, geocodes IPs, resolves hostnames, detects device OS, and renders animated arcs on a world map.","language":"HTML","stars":30,"topics":["data-flow","homelab","ntop","pewpew","pewpew-live","pfsense","traceroute","tracing-applications","tracking","traffic-flow"],"license":null,"category":"self-hosted-apps","readme_excerpt":"NetFlow Live packet flow visualizer — fetches from ntop, geocodes IPs, resolves hostnames, detects device OS, and renders animated arcs on a world map. Architecture Install ntop-ng on pfsense firewall Install docker on a vlan where ntop accessible Ntop fetches data from pfsense Netflow fetches data from Ntop-ng lactive flow endpoint Tested on ntopng Community v.6.2.250909 rev.0 (FreeBSD 15.0) pfsense 2.8.1 Demo https://github.com/user-attachments/assets/9f373a97-af63-43fd-9c9a-c19053923f6b Zero npm dependencies. Pure Node.js built-ins only. --- Quick Start Bare Node.js Open → http://localhost:3000 Docker Compose (recommended) Docker run (manual) --- Project Structure Data flow per poll cycle --- Environment Variables Variable Default Description --- --- --- NTOP HOST ntop.example.com ntop hostname (no https://) NTOP USER admin ntop username NTOP PASS password123 ntop password PORT 3000 UI + API + WebSocket port POLL MS 3000 Fetch interval in milliseconds HOME LAT 10.8505 Latitude for private IPs HOME LON 76.2711 Longitude for private IPs DEFAULT IFID 0 Default interface ID DEFAULT LENGTH 50 Default max flows per poll DEFAULT PROTO tcp Default protocol ( tcp or udp ) DATA DIR /data Directory for caches + snapshots --- API Endpoints Method Path Description --- --- --- GET / Globe UI GET /api/flows Latest enriched flow data (JSON) GET /api/snapshots List of raw snapshot filenames GET /api/status Server uptime, current params, cookie snippet POST /api/renew-session {\"user\":\"…\",\"p","default_branch":null,"files":null,"tree":[],"storefront":"/r/nr-yolo","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/nr-yolo/netflow/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}