TapMap

See where your computer connects on a live world map.

TapMap inspects local socket data, enriches IP addresses with geolocation, and visualizes the locations on an interactive map.

It uses:

• psutil to read active network connections
• MaxMind GeoLite2 databases for IP geolocation
• Dash and Plotly to render an interactive world map

Architecture: local socket scan → IP extraction → GeoIP lookup → map rendering.

TapMap runs entirely on your own machine.
It is not a firewall or a full security suite.
It makes network activity visible on a world map and easy to inspect with hover and click.

README and API reference:

https://olalie.github.io/tapmap/

Download the latest version from the
Releases page

Available builds:

• Windows (zip)

macOS and Linux support is under development.

No installation required. Download, extract, and run.

Tested on Windows 11.

Windows may show a SmartScreen warning the first time you run TapMap.
This is normal for new applications that are not digitally signed.

To start the program:

1. Click More info.
2. Click Run anyway.

TapMap runs locally and opens in your browser.

The web interface runs on a local server at:

http://127.0.0.1:8050/

If it does not open automatically, enter the address manually in your browser.

TapMap uses local MaxMind GeoLite2 databases for geolocation.
The databases are not included in the download.

TapMap works without these files, but map locations will not be displayed.

Required files:

• GeoLite2-City.mmdb
• GeoLite2-ASN.mmdb

Download is free from MaxMind, but requires an account and acceptance of license terms:

https://dev.maxmind.com/geoip/geolite2-free-geolocation-data

After downloading:

1. Start TapMap.
2. Open the data folder from the app.
3. Copy the .mmdb files into that folder.
4. Click Recheck GeoIP databases.

Update recommendation: download updated databases regularly, for example monthly.
Redistribution is subject to the MaxMind license terms.

• Services your computer connects to
• Their approximate locations on a world map
• Nearby clusters highlighted visually
• Unmapped public services with missing geolocation
• Established LAN and LOCAL services
• Local open ports (TCP LISTEN and UDP bound)

All data is collected locally on your machine.

Most computers communicate with dozens of remote systems every day.
You usually cannot see them.

TapMap makes these connections visible within seconds.

• See unexpected connections
• Understand where traffic goes
• Get a quick overview of network activity

Unexpected connections may indicate misconfiguration, background services, or unwanted software.

• TapMap runs locally.
• No connection data is sent anywhere.
• Geolocation uses local MaxMind databases.
• If MY_LOCATION = "auto", TapMap makes a small request to detect your public IP.
• To detect offline status, TapMap performs short connection checks to 1.1.1.1 and 8.8.8.8.

TapMap reads settings from config.py.

Common settings:

• MY_LOCATION
• POLL_INTERVAL_MS
• COORD_PRECISION
• ZOOM_NEAR_KM

Requirements:

• Python 3.10+

Install dependencies:

pip install -r requirements.txt

Run:

python tapmap.py

Run tests:

pytest

TapMap is free and open source.

If you find it useful, consider supporting the project:

• Buy Me a Coffee
  https://www.buymeacoffee.com/olalie

• PayPal
  https://www.paypal.com/donate/?hosted_button_id=ELLXBK9BY8EDU

You can also give the project a star on GitHub.

MIT License