LANlord 🏰

A fast, clean, hacker-style terminal-based network IP & port scanner built entirely in Python + Textual.

Features

Quick Start

# 1. Install dependencies
pip install -r requirements.txt

# 2. Run LANlord
python -m scanner.main

Keyboard Shortcuts

Project Structure

scanner/
├── __init__.py      # Package metadata
├── main.py          # Entry point
├── network.py       # Network detection & IP utilities
├── ping.py          # Host discovery (ICMP + TCP fallback)
├── portscan.py      # Async TCP port scanner
├── export.py        # JSON / CSV export
├── ui.py            # Textual terminal UI
└── styles.tcss      # Textual CSS theme

Usage

1. Launch the app → python -m scanner.main
2. Press D to auto-detect your network
3. Optionally edit the IP range and ports in the Network tab
4. Press S to start scanning
5. Watch live results in the Results tab and logs in the Log tab
6. Export results from the Export tab (JSON / CSV)

Configuration

Default Ports

The default scan targets these common ports:

22, 80, 443, 3306, 8080

Enter a custom list in the Ports input field using:

• Single ports: 80
• Comma-separated: 22,80,443
• Ranges: 1-1024
• Mixed: 22,80,100-200,443,8080-8090

Dependencies

• textual — Terminal UI framework
• rich — Rich text rendering
• psutil — Network interface detection

License

MIT