What do smart devices on your network send?
When I ask for help with a strange device in a forum, I want to show what it does without posting my local IP addresses. Since 0.1.16, iotaudit export can leave them out.
pip install -U iotaudit
iotaudit export audit.json --format md --redact
Example output (sample data):
iotaudit summary: 3 devices, worst grade D, 1 finding
| name | ip | grade | findings | changed | status |
|---|---|---|---|---|---|
| Example Vendor | | D | 1 | | first_run |
| Example Vendor | | C | 0 | | first_run |
| Example Vendor | | C | 0 | | first_run |
--format md gives a Markdown table for GitHub issues, Reddit or the Home Assistant forum.--format csv gives one row per device for a spreadsheet.--compare earlier.json fills in which devices changed since the last audit.--redact works with every format. Devices that only had an IP as their name become “device 1”, “device 2”, and so on.The full HTML report contains local addresses. Since 0.1.18 the shortest path is one command:
pip install -U iotaudit
iotaudit report audit.json --redact
That writes audit.redacted.html with private and link-local IPs replaced by labels like lan-1, MAC addresses by 02:00:00:00:00:01 style placeholders, and local hostnames by host-1. The same device keeps the same label everywhere.
Capture metadata is removed from the top-level meta object and from any nested meta object: source, iface, interface, ssid, path and pcap. The keys iface, interface, ssid and pcap are also dropped if they appear elsewhere on a device. Public cloud destinations stay, as do useful similarly named fields that are not capture metadata (for example a known-issue hint with "source": "port-scan", or an HTTP path on a destination). Add --pdf if you want a PDF (pip install "iotaudit[pdf]").
If you only need the JSON copy, iotaudit redact audit.json still writes audit.redacted.json. Give the result a quick read before you post it. Redaction is not a guarantee of complete anonymity. Only audit networks and devices you own. All data stays local, no telemetry.