Repolode
Submit
olalie

olalie/tapmap

A local desktop and Docker tool that shows your computer's live network connections on an interactive world map, with geolocation and app attribution.

View on GitHubWebsite
Stars
1,581
Forks
89
Open issues
1
Last commit
28 days ago

What is it?

TapMap inspects the sockets on your machine, looks up the geolocation of each remote IP address, and draws the connections on an interactive world map. Hovering or clicking a marker shows which applications are using that network operator, and an optional technical view adds executable paths, processes, PIDs and signatures.

Beyond the live view, TapMap keeps a rolling 30-day local history. The Insights panel flags new apps, providers, countries and ports, while the Daily Activity Report summarises recurrence patterns and provider concentration. Significant Connections can trigger desktop notifications or be published to an MQTT broker.

All data is processed locally, with GeoIP databases used for lookups and no telemetry. It runs as a local web server on Windows, Linux and macOS, or as a Docker container on Linux hosts, and is intended for awareness rather than as a firewall.

Key features

  • 01Shows live remote connections on an interactive world map.
  • 02Attributes connections to applications and network operators.
  • 03Keeps a rolling 30-day local activity history with Insights and a daily report.
  • 04Sends desktop and MQTT notifications for new significant connections.
  • 05Lists open local ports and unmapped public services.

Use cases

  • Checking which countries and services your computer contacts in the background.
  • Spotting a new application that starts making outbound connections.
  • Reviewing network activity patterns on a home or office machine over time.
  • Monitoring a Linux server or host through Docker with process visibility.

Quick start

  1. 1

    Install on macOS with Homebrew

    brew install --cask tapmap
  2. 2

    Or run the Docker image on a Linux host

    docker run --rm \ --network host \ --pid host \ -v ~/tapmap-data:/data \ -e TAPMAP_IN_DOCKER=1 \ olalie/tapmap:latest
  3. 3

    On Windows or Linux, download the installer or .deb package from the Releases page

Things to know

  • Full desktop features such as the system tray and autostart are not available in Docker.
  • Docker is supported on Linux hosts only.
  • Accurate locations require GeoIP databases, which TapMap guides you to install.
  • It is an awareness tool, not a firewall or a full security suite.

Topics

#network-visualization#geolocation#interactive-map#network-monitoring#dash#plotly#python#observability#docker#internet-observability

FAQ

What is tapmap?
A local desktop and Docker tool that shows your computer's live network connections on an interactive world map, with geolocation and app attribution. TapMap inspects the sockets on your machine, looks up the geolocation of each remote IP address, and draws the connections on an interactive world map. Hovering or clicking a marker shows which applications are using that network operator, and an optional technical view adds executable paths, processes, PIDs and signatures.
Is tapmap free to use? What license does it have?
tapmap is open source under the MIT license. Check the license terms before using it in commercial products.
Is tapmap still maintained?
Actively maintained. The last commit to tapmap was on Sep 22, 2026.
What can I use tapmap for?
Checking which countries and services your computer contacts in the background. Spotting a new application that starts making outbound connections. Reviewing network activity patterns on a home or office machine over time. Monitoring a Linux server or host through Docker with process visibility.
How do I install tapmap?
Install on macOS with Homebrew: brew install --cask tapmap Or run the Docker image on a Linux host: docker run --rm \ --network host \ --pid host \ -v ~/tapmap-data:/data \ -e TAPMAP_IN_DOCKER=1 \ olalie/tapmap:latest On Windows or Linux, download the installer or .deb package from the Releases page
Where can I get tapmap?
The source code and installation instructions are on GitHub: https://github.com/olalie/tapmap

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects