rfparty-monitor ![stability-experimental](https://img.shields.io/badge/stability-experimental-orange.svg)
rfparty is a new way to see BLE
![rfparty collage](https://img.youtube.com/vi/kDboDShA8do/0.jpg)
Components
rfparty-monitor
rfparty.xyz ( code )
Usage
rfparty-monitor is a tool for wireless situational awareness and debugging. It's like a tricorder for your wireless world.
Android
Linux
File Paths
/data/rfparty/ble
/data/rfparty/gps
/data/rfparty/wifi
/data/rfparty/logs
/usr/bin/rfparty-info
/usr/bin/rfparty-monitor
/etc/systemd/system/rfparty-monitor.service
Installation
sudo ./scripts/install.sh
Requirements
- Ubuntu 20.04 or debian equivalent
- Packages:
build-essential bluetooth bluez bluez-hcidump libbluetooth-dev libudev-dev gpsd gpsd-clients gpsbabel python-gps wireless-tools aircrack-ng libpcap-dev libavahi-compat-libdnssd-dev
sudo ./scripts/install-requirements.sh
- nodejs LTS 18.x or 20.x
- npm <= 10.3.x
- USB GPS (optional)
- Bluetooth dongle
- CSR 4.x works well
- Raspi internal works well on Ubuntu 18.04 but not 20.04
- Wifi dongle supporting promiscuous mode
Alternate GPS Source
Any smart phone or device capable of outputting GPX 1.0 is currently supported.
Follow and Support
Roadmap πΊοΈ
- Support PCAP πΎ
- Hidden Wifi AP
- Wifi Clients
- Improved error handling π§
- Improve configuration π οΈ
- Database optimization π¨πΏβπ»
- High endurance deployments
- Dynamic detail
- Protocol filter
- Running Statistics
- Protocol Improvements π
- Improve location pipeline πΊοΈ
- Log directly to GPX
- Record GPX track to db
- Realtime sharing π‘
- Wireless Intrussion Detection (WIDS) π‘οΈ
- Common Wifi threats
- BLE threats
- Red teaming π₯·πΌ
- More frequencies, more protocols ποΈ
- LoRa
- LoRaWAN
- SDR tuning & capture
- ... and much more β¨
Troubleshooting
Converting NMEA to GPX
cd /data/rfparty/gps
gpsbabel -i nmea -f "track.foo.nmea" -o gpx,gpxver=1.1 -F "track-foo.gpx"
Selecting Wifi Interface
In ./src/BLEMonitor.js
Set SCANNING_WIFI_IFACE
to your desired wifi scanning interface for home detection.
Promiscuous Wifi Interface
In ./scripts/start-snif.sh change the arodump commands to correctly select your desired promiscuous wifi interface.