Skip to content

About

Offline LAN scanner with a built-in web dashboard. Finds devices, vendors and services on your network. Single binary, no telemetry.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

85 Commits

Folders and files

Repository files navigation

LocalLanView

See every device on your network, what it is, and what it's running. One binary, a web dashboard, and nothing ever leaves your network.

Dashboard

Only scan networks you own or are authorized to administer.

Features

  • Finds devices with the ARP table, mDNS/Bonjour, SSDP/UPnP, NetBIOS and LLMNR, plus raw ARP and ICMP sweeps when run as admin/root
  • Light port scan with banner grabbing (rate limited, -no-port-scan to skip)
  • Vendor lookup from the embedded IEEE registry (MA-L, MA-M, MA-S); randomized MACs are labeled as such
  • Guesses device type (router, printer, TV, phone...) and shows why and how sure
  • Remembers first/last seen, IP and hostname history
  • Alerts for new devices, newly opened ports, and an IP moving to a new MAC
  • Rename, tag and mark devices as trusted; export to CSV/JSON
  • Fully offline: no telemetry, no background update checks, no CDN
  • One-click updates from Settings: downloads the latest release, checks it against SHA256SUMS and restarts

Quick start

Download the binary for your OS from Releases, or build it (below). Release files are named LocalLanView-<version>-<os>-<arch>. On Linux and macOS, check the download against SHA256SUMS, make it executable and run it:

sha256sum -c --ignore-missing SHA256SUMS   # macOS: shasum -a 256 -c --ignore-missing SHA256SUMS
chmod +x LocalLanView-v*-linux-amd64
./LocalLanView-v*-linux-amd64

It opens http://127.0.0.1:8787. The first run prints a random password once. Log in as admin and change it under Settings.

Windows: the exe isn't code-signed, so SmartScreen will say "Windows protected your PC". Click More info, then Run anyway. Check the file against SHA256SUMS first if you want to be sure it's the real one: Get-FileHash .\LocalLanView-*.exe.

macOS: same story with Gatekeeper. Run xattr -d com.apple.quarantine ./LocalLanView-* once, or right-click the file and choose Open.

Privileges

-mode Behavior
auto (default) Uses elevated features if already running as admin/root, otherwise standard
std Never uses elevated features
elv Requires admin/root, exits with instructions otherwise

Elevated mode adds the raw ARP sweep and ICMP, which find devices that ignore everything else. It never asks for elevation itself. On Linux you can skip root with:

sudo setcap cap_net_raw+ep ./LocalLanView

When started with sudo, doas or pkexec, it drops back to your user after opening its sockets. If root starts it directly (a service, say), name the account to switch to with -run-as; otherwise it warns that it is staying root. The Capabilities page shows which features are on and why.

Options

Flag Default
-addr 127.0.0.1:8787 host:port, :port or port (the last two bind to loopback)
-lan off Open the console to other devices on this network and remember it (-lan=false turns it off)
-addr-fallback off Use a free port if the chosen one is taken
-allow-host Extra names the console answers to off loopback, comma-separated
-user admin Console username
-password-file Read the password from a file
-set-password Prompt for a new password (or take it from the file/env)
-mode auto auto, std or elv
-run-as Account to switch to when started as root without sudo
-data-dir per-user config dir Database location
-scan-interval 5m Time between scans
-interface, -subnet auto Override detection (subnet must be on the interface). Auto-detection skips VPN tunnels and Docker/VM bridges
-probe-rate 100 Max probe packets per second
-no-port-scan off Skip TCP probes
-tls-cert, -tls-key Serve HTTPS with your certificate
-tls-self-signed off Serve HTTPS with a generated certificate
-webhook POST alerts to a local/private URL
-notify off Desktop notifications for alerts
-no-open-browser, -version

The password can also come from LOCALLANVIEW_PASSWORD. There's no -password flag on purpose: it would show up in ps and shell history. A password from -password-file or the variable is applied when it's new; starting again with the same one keeps any change made on the Settings page. -set-password always applies it.

Using it from your phone or other devices

LAN access is off by default. To turn it on, set your own password first (Settings, or -set-password), then either:

  • tick Open LocalLanView to devices on this network under Settings, or
  • start it with -lan.

The console restarts on every network interface, on the same port, over HTTPS with a self-signed certificate (browsers warn about it once). Typing the address without https:// works too; you're sent to the HTTPS page. The address to use, such as https://192.168.1.50:8787, is shown under Settings, in the sidebar's Network card and in the terminal. The choice is remembered across restarts; untick the box or run with -lan=false to go back to this machine only. If other devices can't connect, allow the port through this computer's firewall.

For full control, -addr still works and overrides the setting:

LOCALLANVIEW_PASSWORD='a long passphrase' ./LocalLanView -addr 0.0.0.0:8787 -tls-self-signed

Binding to anything other than loopback is refused until you've set your own strong password. Without TLS you'll get a warning, since logins would travel in plain text.

To block DNS rebinding, the console only answers to IP addresses, this machine's name (also as name.local) and the names in your TLS certificate. If you reach it through another name, such as a DNS entry on your router, add it with -allow-host nas.lan.

Limitations

  • It sees only the subnet it's attached to. VLANs and guest networks need their own instance.
  • Sleeping devices and ones that ignore probes look offline. That's why devices show "last seen" instead of up/down.
  • Randomized (private) MACs hide the vendor and can make one phone look like several devices over time. Names and services still help.

Building

Needs Go only.

make build      # this machine
make dist       # all OS/arch combinations into dist/, with SHA256SUMS
make test

On Windows: .\build.ps1 or .\build.ps1 -Dist. Builds are static (CGO_ENABLED=0) and reproducible.

More

License

MIT

About

Offline LAN scanner with a built-in web dashboard. Finds devices, vendors and services on your network. Single binary, no telemetry.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages