Native macOS Application|
In Development

NetScope

Real-time network intelligence for macOS.

Source Code

105

Tests Passing

8

Data Sources

1-10s

Poll Rate

Overview

NetScope gives you instant visibility into your Mac's network stack without memorizing terminal commands. It collects data from ifconfig, netstat, lsof, scutil, ping, and arp at configurable intervals, validates and deduplicates all data, and presents it in a JARVIS-inspired heads-up display. Features include 30-minute historical bandwidth charts via SwiftUI Charts, process-aware outbound connections resolved via lsof, routing table with default route highlighting, DNS resolver cards, ARP-based LAN device discovery, and latency probing. Full accessibility support including VoiceOver, Reduce Motion, Differentiate Without Color, and High Contrast. Self-updates via GitHub Releases.

Stack

Swift 6SwiftUISwiftUI ChartsGRDB.swiftswift-logGitHub Actions

Features

What it does.

Network Monitoring

  • 30-minute historical bandwidth charts with download/upload series
  • Process-aware outbound connections resolved via lsof
  • LAN device discovery via ARP table with hostname resolution
  • Routing table with default route highlighting and search
  • DNS resolver cards with nameservers, search domains, and reachability
  • Latency probing with configurable target hosts

Data Pipeline

  • 8 async collectors running on configurable timers
  • Triple data validation: deduplication, format checks, bounds validation
  • Concurrent pipe reading to prevent shell buffer deadlocks
  • Historical bandwidth and latency persistence via GRDB/SQLite
  • ProcessMapper actor for lsof-based connection enrichment

macOS Native

  • JARVIS/Tony Stark HUD-themed interface with arc reactor app icon
  • Full accessibility: VoiceOver, Reduce Motion, Differentiate Without Color
  • Configurable poll intervals, latency targets, and display preferences
  • Self-update via GitHub Releases (download, mount DMG, replace, relaunch)
  • Global search filtering across all views

Architecture

How it's built.

1

NetScopeCore

Models, collectors, database, services (shared library)

2

NetScopeApp

SwiftUI views, AppState, theme (macOS app)

3

NetScopeCLI

Command-line launcher via swift-argument-parser

4

CollectionEngine

Orchestrates 8 collectors with async timers

5

ProcessMapper

Actor-isolated lsof parser for connection enrichment

6

GRDB.swift

SQLite in WAL mode for historical data

Interested in this project?

Get in touch →
← Back to all projects