nr-yolo

nr-yolo / netflow

Public

Live packet flow visualizer — fetches from ntop, geocodes IPs, resolves hostnames, detects device OS, and renders animated arcs on a world map.

data-flow homelab ntop pewpew pewpew-live
10
1
100% credibility
Found Apr 07, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
HTML
AI Summary

A browser-based tool that visualizes live network flows from an ntop monitor as animated arcs on an interactive world map with geolocation and device detection.

How It Works

1
🕵️ Discover NetFlow Globe

You find a fun tool that turns your home network traffic into animated arcs flying across a world map.

2
📝 Note your monitor details

Write down the web address and login info for your network traffic watcher.

3
🚀 Launch the viewer

Start the viewer with a simple command, and it connects to your network watcher automatically.

4
🌐 Open in your browser

Go to the shown web address in any browser to see the spinning globe ready for action.

5
✨ Watch live flows animate

Colorful lines start dancing between locations, showing real-time connections from your devices worldwide.

6
🔍 Zoom and filter views

Zoom in to spot device names and countries, filter traffic types, or pause to examine details.

🎉 Enjoy network insights

You now have a beautiful live dashboard revealing what's happening on your network at a glance.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is netflow?

Netflow turns raw network flows from ntopng into a live, animated world map of packet traffic, drawing arcs between geocoded IPs with hostname resolution and device OS detection via color-coding (Android green, Windows blue, etc.). It polls ntop every few seconds, enriches data with geo lookups and reverse DNS, then pushes real-time updates over WebSocket to browsers. Built in pure Node.js with zero npm dependencies and Docker Compose support, it runs on pfSense setups for instant live packet map visualization.

Why is it gaining traction?

Unlike static github netflow analyzers, this delivers a dynamic globe UI with zoom/pan controls, protocol filters (TCP/UDP), and interface stats like Mbps throughput—all without setup hassle via docker-compose up. The OS detection from hostnames spots Android devices or Linux servers in traffic, and persistent caches keep it snappy even on restarts. Devs dig the API endpoints for flows/status and session renewal, making it a quick win for live packet capturing and analysis dashboards.

Who should use this?

Homelab network admins on pfSense/ntopng wanting a live packet tracer for traffic patterns, or ops teams tracking live packet loss with visual arcs. Ideal for devs building github netflow collector extensions or monitoring VLAN flows without heavy tools. Skip if you're not already running ntop—it's tightly coupled.

Verdict

Grab it for a proof-of-concept live packet map if you have ntop; Docker makes spinning it up trivial, and docs cover env vars plus UI controls well. With only 10 stars and 1.0% credibility score, it's early-stage and untested at scale—prototype responsibly, watch for session handling quirks.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.