Skip to content

A Mainline DHT listener that monitors and logs DHT network activity in real-time.

License

Notifications You must be signed in to change notification settings

MiguelMedeiros/dht-listener

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DHT Listener & Analyzer

A real-time monitoring system for the BitTorrent DHT (Distributed Hash Table) network with geographic node visualization.

20250223-1446-56.3390126.mp4

🌟 Features

  • Real-time Monitoring: Continuous tracking of active DHT nodes
  • Geographic Visualization: Interactive map showing node locations
  • Statistical Analysis: Detailed DHT network metrics
  • Modern Architecture: Node.js Backend + Next.js Frontend

🚀 Technologies

Backend

  • Node.js
  • Express
  • SQLite
  • bittorrent-dht
  • GeoIP-lite

Frontend

  • Next.js 14
  • React
  • Leaflet (for maps)
  • TailwindCSS
  • TypeScript

📦 Installation

Installing All Dependencies

Before starting the project, run the following command in the project root to install dependencies for the root, backend, and frontend:

npm run install-all

How to Run the Project

Run the start script in the project root:

npm run start

This will start both the "backend" and "frontend" directories concurrently.

The system will be available at:

📡 API Endpoints

  • GET /nodes: General node statistics
  • GET /nodes/all: Paginated list of all nodes
  • GET /stats: Real-time network statistics

🗺️ Map Features

  • Real-time DHT node visualization
  • Automatic clustering for better performance
  • Detailed node information on click
  • Geographic distribution by country
  • Automatic updates every 10 seconds

📊 Collected Metrics

  • Total active nodes
  • Geographic distribution
  • Node uptime
  • Appearance frequency
  • Country-based statistics

About

A Mainline DHT listener that monitors and logs DHT network activity in real-time.

Resources

License

Stars

Watchers

Forks