https://github.com/krisarmstrong/network-tools
Everything from `network_discovery`, `network_discovery_listener`, `network_discovery_parser`,
https://github.com/krisarmstrong/network-tools
cdp cli discovery lldp network-discovery networking packet-analysis packet-capture pcap python scapy
Last synced: 3 months ago
JSON representation
Everything from `network_discovery`, `network_discovery_listener`, `network_discovery_parser`,
- Host: GitHub
- URL: https://github.com/krisarmstrong/network-tools
- Owner: krisarmstrong
- License: mit
- Created: 2025-11-07T21:39:28.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-12T19:30:41.000Z (5 months ago)
- Last Synced: 2026-01-13T00:11:44.056Z (5 months ago)
- Topics: cdp, cli, discovery, lldp, network-discovery, networking, packet-analysis, packet-capture, pcap, python, scapy
- Language: Python
- Size: 56.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# network-tools
[](https://github.com/krisarmstrong/network-tools/actions/workflows/checks.yml)
[](https://github.com/krisarmstrong/network-tools/actions)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://github.com/psf/black)
Everything from `network_discovery`, `network_discovery_listener`, `network_discovery_parser`,
`pcap_parser`, and `packet_listener_linux_perf_test` now lives here.
```bash
pip install .
network-tools --help
```
## Commands
### `network-tools listen`
Capture CDP/LLDP/EDP/FDP packets either live (`--interface eth0`) or from a PCAP (`--pcap capture.pcap`).
Results are appended to `--output` (default `discovery_log.txt`).
### `network-tools parse-json`
Parse NetAlly `discovery.json` host lists, print formatted host info, and count valid IPv4 addresses.
```bash
network-tools parse-json discovery.json
```
### `network-tools filter-pcap`
Filter NetAlly reflector traffic (MAC prefix `00:c0:17`, UDP/TCP port 3842) and dump packet details.
```bash
network-tools filter-pcap reflector_capture.pcap reflector_report.txt
```
## Development & CI
```bash
python -m venv .venv && source .venv/bin/activate
pip install -e .[test]
python -m pytest
```
The repo ships with `nox -s tests` and `.github/workflows/ci.yml`; versions are stored in `pyproject.toml` and
release-please manages tags and changelog entries.
## Packet Performance Listener
The original C-based high-performance listener from `packet_listener_linux_perf_test` is preserved under
`extras/packet_listener_linux/`. Build with `cmake` or `gcc` on Linux hosts when you need raw-socket throughput testing.
## WiFi Analysis
Comprehensive Wi-Fi packet parsing and analysis capabilities (merged from wi-fi-packet-parser).
### Features
- PCAP file parsing
- Wi-Fi frame analysis
- OUI lookup and vendor identification
- Channel and signal strength analysis
## Switch Management
Network switch port querying and management (merged from switch-port-query).
### Features
- SNMP-based port queries
- Port configuration management
- VLAN information retrieval
- PoE status monitoring
## Network Monitoring
TCP connectivity monitoring tools (merged from tping-monitor).
### Features
- TCP ping (tcping) functionality
- Continuous network monitoring
- Connection latency tracking
- Availability reporting
## Documentation
- [WiFi Packet Parser](docs/WIFI_PARSER.md)
- [Switch Port Query](docs/SWITCH_QUERY.md)
- [TCP Ping Monitor](docs/TPING_MONITOR.md)
---
Enhanced from:
- wi-fi-packet-parser
- switch-port-query
- tping-monitor
## Development
Run the full local checks:
```bash
./check.sh
```