Termux-WiFi-map
The script is designed for comprehensive scanning and saving of Wi-Fi network parameters in your area. After saving, it also allows convenient listing of data and exporting it to other files (including KML).
release date: 2025-01-09
about
Termux-WiFi-map is a comprehensive Bash utility for Termux on Android that scans nearby Wi-Fi access points (APs), records their metadata and optionally geolocates them using Termux location providers. It is intended for network hobbyists, security researchers, and anyone who needs a lightweight, non-root Wi-Fi mapping tool on mobile devices.
features
- Passive Wi-Fi scanning via `termux-wifi-scaninfo`.
- GPS/location integration via `termux-location` (supports providers: gps, network, passive).
- Save/export scans in multiple formats: JSON (single-line), pretty JSON (PJSON), JSONL (newline-delimited JSON), CSV, KML.
- Cache of collected APs for later export or analysis (default: $HOME/.cache/BuriXon-code/wifi_scan_cache.jsonl).
- Continuous scanning mode with adjustable delay (supports "none" for 0s / fastest possible).
- Vibration feedback control (can be disabled).
- File validation mode: checks structure of saved files for correctness.
- Robust error handling: automatic Termux API restart routine (unless configured to exit).
- Lightweight: written in POSIX/Bash and relies on Termux utilities — no root required.
- GPS/location integration via `termux-location` (supports providers: gps, network, passive).
- Save/export scans in multiple formats: JSON (single-line), pretty JSON (PJSON), JSONL (newline-delimited JSON), CSV, KML.
- Cache of collected APs for later export or analysis (default: $HOME/.cache/BuriXon-code/wifi_scan_cache.jsonl).
- Continuous scanning mode with adjustable delay (supports "none" for 0s / fastest possible).
- Vibration feedback control (can be disabled).
- File validation mode: checks structure of saved files for correctness.
- Robust error handling: automatic Termux API restart routine (unless configured to exit).
- Lightweight: written in POSIX/Bash and relies on Termux utilities — no root required.
compatibility
The script checks presence of these commands and will abort if any are missing:
- `termux-wifi-scaninfo` (Termux:API)
- `jq` (JSON parsing)
- `termux-location` (Termux:API)
- `termux-api-start` / `termux-api-stop` (API control)
- `timeout` (coreutils or busybox)
- `awk`, `sed`, `tr`, `date` (shell utilities)
- `termux-vibrate` (optional unless you rely on vibrations)
- `termux-wifi-scaninfo` (Termux:API)
- `jq` (JSON parsing)
- `termux-location` (Termux:API)
- `termux-api-start` / `termux-api-stop` (API control)
- `timeout` (coreutils or busybox)
- `awk`, `sed`, `tr`, `date` (shell utilities)
- `termux-vibrate` (optional unless you rely on vibrations)