Sparrow-WiFi
Integrated Wi‑Fi / Bluetooth / SDR analysis platform for Linux with optional remote agent and HackRF/Ubertooth workflows.
Why Use Sparrow-WiFi
Choose Sparrow when you need one platform for:
- Wi‑Fi scanning plus Bluetooth awareness
- source hunting / telemetry workflows
- spectrum overlays with HackRF One or Ubertooth One
- remote scanning via a JSON REST agent
- mobile, Pi, drone, or rover-mounted sensors
Quick Start
# install deps (common Linux/Kali/Debian path)
git clone https://github.com/ghostop14/sparrow-wifi
cd sparrow-wifi
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# run desktop app
sudo venv/bin/python3 ./sparrow-wifi.py
Core Modes
| Component | Use |
|---|---|
sparrow-wifi.py |
Desktop GUI for Wi‑Fi/BT/spectrum awareness |
sparrowwifiagent.py |
Headless HTTP agent for remote sensors |
sparrow-droneid |
Drone RemoteID Wi‑Fi/BLE detection workflow |
sparrow-elastic.py |
Optional Elasticsearch / OpenSearch bridge |
Hardware-Aware Use Cases
Standard adapter only
- Wi‑Fi scanning
- BLE advertisement scanning
- GPS-assisted mapping
With HackRF One
- 2.4 GHz and 5 GHz spectral overlays
- broader RF awareness alongside Wi‑Fi scans
With Ubertooth One
- 2.4 GHz spectrum and deeper Bluetooth visibility
Remote Agent Workflow
sudo ./sparrowwifiagent.py
# default API port 8020
Example API calls:
curl http://sensor:8020/wireless/interfaces
curl http://sensor:8020/wireless/networks/wlan0
curl http://sensor:8020/bluetooth/discoverystarta
curl http://sensor:8020/bluetooth/discoverystatus
Why It Belongs in Wireless
Sparrow fills the gap not covered by the current category:
- Bluetooth-first workflows
- HackRF/Ubertooth-assisted spectrum analysis
- remote/headless wireless sensor deployment
- JSON/API-friendly automation
Relationship to Other Skills
| Skill | Best use |
|---|---|
kismet |
Passive WIDS / long-running passive RF logging |
aircrack-ng |
Focused Linux monitor-mode capture and cracking workflows |
bluez |
Core Bluetooth CLI operations |
sparrow-wifi |
Combined Wi‑Fi/Bluetooth/SDR awareness with APIs and sensors |
Resources
| File | When to load |
|---|---|
references/hackrf-bluetooth-agent-workflows.md |
For HackRF One, Bluetooth, remote agent, API, and hardware-selection workflows |