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.
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.
- 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
/24through/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.
- Download
LanPilot-Setup-0.1.3.exeandSHA256SUMS.txtfrom the v0.1.3 preview release. Read its validation limitations before testing. The separate sources-and-licenses archive is not needed to install. - Verify the SHA-256 checksum.
- Install Npcap if it is not already installed.
- Run the installer as Administrator.
- 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.
| 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.
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.
Install the .NET 10 SDK and Inno Setup 6, then run:
.\build.ps1This 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- Read CONTRIBUTING.md before submitting changes.
- Use GitHub Issues for reproducible bugs and feature requests.
- Report security issues according to SECURITY.md, not in a public issue.
- Third-party licenses are listed in THIRD_PARTY_NOTICES.txt.
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.
