Skip to main content

A python based local network scanner

Project description

LANscape

A local network scanner with a built-in web UI. Discover devices, open ports, and running services on your network.

The UI was recently converted into react, stored in a separate repo: mdennis281/lanscape-ui

pip install lanscape
python -m lanscape

Stats:

Version Monthly Downloads

Latest release:

Stable RC Beta

Docker:

lanscape lanscape-arm

Health:

pytest pylint packaging docker


LANscape UI

More screenshots

Scan Configuration

Port Detail


Flags

Flag Description
--version Show the installed version and exit
--ui-port <number> Port for the web UI (default: auto)
--ws-port <number> Port for the WebSocket server (default: 8766)
--ws-server Start WebSocket server only (no UI)
--persistent Don't auto-shutdown when the browser tab closes
--mdns-off Disable mDNS service discovery
--logfile <path> Write log output to a file
--loglevel <level> Set log level: DEBUG, INFO, WARNING, ERROR, CRITICAL (default: INFO)
--debug Shorthand for --loglevel DEBUG
python -m lanscape
python -m lanscape --version
python -m lanscape --ui-port 8080
python -m lanscape --debug --persistent
python -m lanscape --logfile /tmp/lanscape.log --loglevel WARNING
python -m lanscape --ws-server --ws-port 9000

Docker (Linux Only)

Not recommended for most users. Network scanning requires direct LAN access (ARP, ICMP, broadcasts), which conflicts with Docker's network isolation. The Docker image requires --network host mode, which only works on Linux — on Windows and macOS, Docker Desktop runs inside a VM so --network host exposes the VM's network, not your physical LAN.

For most users, pip install lanscape is the better option.

If you're running on a Linux host and still want to use Docker, see the full setup guide: Docker Setup Instructions

Troubleshooting

MAC Address / Manufacturer is inaccurate or unknown

LANscape does an ARP lookup to determine MAC addresses. This can require elevated permissions to get accurate results — try running your shell as admin.

Scan accuracy seems low

The scanner uses a combination of ARP, ICMP, and port probing to find devices. If results aren't great out of the box:

  • Tweak the scan configuration preset (accessible from the gear icon)
  • Set up ARP lookup properly — see ARP issues
  • Open an issue if something still seems off

Something else

Feel free to submit an issue with details about what you're seeing.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lanscape-3.5.2b2.tar.gz (2.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lanscape-3.5.2b2-py3-none-any.whl (2.1 MB view details)

Uploaded Python 3

File details

Details for the file lanscape-3.5.2b2.tar.gz.

File metadata

  • Download URL: lanscape-3.5.2b2.tar.gz
  • Upload date:
  • Size: 2.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for lanscape-3.5.2b2.tar.gz
Algorithm Hash digest
SHA256 5d00eb81a1a0410308295e525ae3f8441086284559f57bee239fca9b61910a6f
MD5 7b6aac1513ca414bb50ad2bdf5c9b1b3
BLAKE2b-256 da1c764be14281d61deea67fcb141fc17e1be82f53a57d9a8a5a447f4f4ec60b

See more details on using hashes here.

File details

Details for the file lanscape-3.5.2b2-py3-none-any.whl.

File metadata

  • Download URL: lanscape-3.5.2b2-py3-none-any.whl
  • Upload date:
  • Size: 2.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for lanscape-3.5.2b2-py3-none-any.whl
Algorithm Hash digest
SHA256 9438aa9b92332e0fdf45b29926e1276492bb3a03a5915d36338efecc7a9e5521
MD5 0c45fdff7a69ff97d4b56b248fdec444
BLAKE2b-256 fa8253cb3a00d78833df45ebce66dc53d55a81c135670d288d2337d982b72b22

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page