Skip to content

Repository files navigation

LanPilot logo

LanPilot

Open-source network and application bandwidth control for Windows.

Build License: MIT Release

Important

Use LanPilot only on networks you own or are explicitly authorized to administer. The first release is a preview and should be tested on a non-critical network before regular use.

What LanPilot does

LanPilot is a native Windows desktop application for seeing devices on a local IPv4 network, monitoring live traffic, and applying download, upload, or blocking policies. It also provides per-application controls for software running on the local computer.

  • Live discovery for home and small-office networks up to /24.
  • Persistent device names, groups, guest defaults, and device overrides.
  • Per-device download/upload limits and internet blocking.
  • Per-application live throughput, independent limits, and blocking.
  • Schedules and reusable rule presets.
  • One-second UI updates with shared readings across screens.
  • Safe pause, corrective ARP restoration, tray operation, and automatic reconnect.
  • Local-only SQLite storage; no cloud account or remote HTTP API.

Requirements

  • Windows 10 22H2 or Windows 11, x64.
  • Administrator permission for the LanPilot service and network controls.
  • Npcap installed separately for full device discovery and control. Npcap is not included in the installer.
  • An IPv4 network with prefix /24 through /30.

IPv6 traffic can be detected but is not shaped in the v0.1 preview series. Networks using client/AP isolation, protected switches, or ARP-spoofing defenses may prevent device control.

Install

  1. Download LanPilot-Setup-0.1.3.exe and SHA256SUMS.txt from the v0.1.3 preview release. Read its validation limitations before testing. The separate sources-and-licenses archive is not needed to install.
  2. Verify the SHA-256 checksum.
  3. Install Npcap if it is not already installed.
  4. Run the installer as Administrator.
  5. Confirm that you own or are authorized to manage the selected network.

The preview installer is not digitally signed, so Microsoft SmartScreen may display a warning. Inspect the source and checksum before running it.

Architecture

Project Responsibility
LanPilot.App WPF/WPF-UI desktop interface, tray integration, and local client.
LanPilot.Service Elevated Windows service for capture, forwarding, policies, and storage.
LanPilot.Contracts Versioned JSON-over-Named-Pipe contracts.
LanPilot.Tests Network math, policy, persistence, packet, and IPC tests.

The UI and service communicate through the ACL-protected local pipe LanPilot.Control.v1; LanPilot opens no HTTP server or network control port. See Architecture for details.

Privacy

LanPilot stores device identities, user-defined policies, and aggregated byte totals under %ProgramData%\LanPilot. UI preferences are stored under %LocalAppData%\LanPilot. Packet payloads, websites, domains, and DNS queries are not recorded. See Privacy.

For crashes, use the included Debug symbols, local exception logs, and optional memory dumps.

Build from source

Install the .NET 10 SDK and Inno Setup 6, then run:

.\build.ps1

This restores packages, builds with warnings as errors, runs tests, publishes self-contained untrimmed win-x64 output, creates the installer, and generates its SHA-256 checksum under a fresh artifacts\releases\<version>-<guid>\ directory. Previous builds and running packages are never deleted.

To build without the installer:

.\build.ps1 -SkipInstaller

Contributing and support

License

Copyright © 2026 Ali Teleb.

LanPilot is licensed under the MIT License. SelfishNet source code and assets are not included; LanPilot is an independent clean-room implementation inspired only by its user-visible purpose.

About

Open-source network and application bandwidth control for Windows

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages