Maperick

Visualize your network connections on a world map — right in your terminal.

Built with Rust Real-time TUI Native Mac App
Download Latest Release See all platforms

Features

Everything you need to understand your network at a glance.

Real-time Monitoring

Tracks active TCP connections continuously with configurable refresh intervals. Watch connections appear and disappear as your system communicates with the world.

Geolocation Mapping

Pinpoints server locations using MaxMind GeoLite2 databases. Every connection is resolved to a geographic coordinate and rendered on the world map.

Connection History

Persists all-time connection statistics in a local SQLite database. Track which IPs you've connected to, when, and how often — across sessions.

Interactive TUI

Navigate with keyboard shortcuts, switch between multiple tabs, and view color-coded connection statuses. A full terminal UI powered by Ratatui.

Per-Process Tracking

See which processes are making connections. The Processes tab shows a split view with per-process connection maps and statistics.

Auto GeoIP Download

Automatically downloads the GeoLite2 database on first run. No manual setup required — just run and start exploring your network.

See it in action

A full-featured network visualization running entirely in your terminal.

maperick — Map Tab
Map view showing TCP connections on a world map

World map view with geolocated connections

maperick — Servers Tab
Servers view with connection statistics

Server statistics with all-time history

maperick — Processes Tab
Processes view showing per-process connections

Per-process connection tracking

Two ways to explore your network

A lightweight CLI for power users and a native macOS app for everyone else.

CLI

Terminal App

A single binary with zero runtime dependencies. Built in Rust for minimal memory usage and instant startup. Runs on Linux, macOS, and Windows.

  • Small footprint — single static binary
  • Cross-platform: Linux, macOS, Windows
  • Interactive TUI powered by Ratatui
  • SSH-friendly — works over remote sessions
cargo install maperick
macOS

Native Mac App

A full SwiftUI application with a 3D globe visualization, menu bar integration, and native macOS look and feel. Installable via DMG.

  • Native SwiftUI interface
  • 3D globe with SceneKit
  • Menu bar quick-access widget
  • DMG installer on GitHub Releases
Download DMG

Get started

Clone, build, and run — or just use cargo install.

Installation

Get up and running in under a minute.

bash 
# Clone and build
git clone https://github.com/schlunsen/maperick.git
cd maperick
cargo build --release

# Run with your GeoLite2 database
./target/release/maperick -e -p GeoLite2-City.mmdb

CLI Usage

Simple, focused command-line interface.

terminal 
maperick [OPTIONS]

Options:
  -t, --tick-rate <ms>       Update interval (default: 250)
  -p, --path <PATH>          Path to GeoLite2 MMDB file
  -e, --enhanced-graphics    Enable Unicode symbols
  -h, --help                 Print help