Download IoT Inspector

Download

You can install IoT Inspector on your computer to monitor your IoT devices.

  • See how we inspect a Chromecast and a smart lightbulb in this blog post.
  • Watch a YouTube video on how to run IoT Inspector on your computer.
  • Slide deck that provides an overview of IoT Inspector.


Understand how we collect data

Princeton IoT Inspector is a part of a research project that helps (i) consumers learn more about their IoT devices and (ii) researchers collect anonymous IoT network data.

It is important you understand how IoT Inspector works, how it collects data anonymously, and the risks involved in running this software.

  • How IoT Inspector works:

    1. It conducts ARP-spoofing on your network to intercept network traffic.
    2. It removes personally identifiable information; see this FAQ.
    3. It uploads the data to a server at Princeton University; see this FAQ.
    4. The server performs the analysis and presents the result via the web browser.
  • What data is collected: See this FAQ.

  • Risks

    • You might accidentally send sensitive information to our server; see this FAQ.
    • Your network may slow down or stop working, and our software may be buggy. If you think your network is down as a result of IoT Inspector, stop IoT Inspector and reboot your router. See this FAQ.
    • Our server might get hacked (unlikely); see this FAQ.


Download

Linux

The following instructions have been tested on the latest Ubuntu and Raspberian (on Raspberry Pi).

  1. Download the installation script using the browser, or run: wget https://raw.githubusercontent.com/noise-lab/iot-inspector-client/master/linux-setup.sh.

  2. Run the installation script on the command line: bash linux-setup.sh. You will be prompted to enter the root password.

  3. To start IoT Inspector, run ~/princeton-iot-inspector/linux-start-inspector.sh on the command line. You will be prompted to enter the root password.

  4. IoT Inspector will present on the command line a private URL for you to view the inspection report. You can open the URL on any computer that you trust. For example, you can run IoT Inspector on a Raspberry Pi and open the URL on a different computer (or even mobile device).

Note:

  • You can run IoT Inspector on Raspberry Pi purely via the command line; no graphical user interface is needed. IoT Inspector will show you a private URL, which you can paste on a different computer (or mobile device) to view anywhere.

  • Some users with Pi-Holes on their networks reported outages on their Pi-Holes. It is possible that Pi-Holes may detect and prevent ARP-spoofing attempts by IoT Inspector (a technique to collect traffic from the network).

  • Some users experienced the following error when launching IoT Inspector: ImportError: No module named scapy_ssl_tls.ssl_tls. You can solve this issue by forcing the install: sudo pip2 install --ignore-installed scapy-ssl_tls.

  • For all other Unix/Linux distributions (including macOS), you may want to change this line accordingly before setting up IoT Inspector.

  • Do not run IoT Inspector on Windows 10’s Linux subsystem; you may run into this issue.

  • More issues? File a bug here.


macOS

Download a precompiled binary: start_inspector_mac.zip (sha256)

Requirements:

  • macOS High Sierra or Mojave
  • Firefox or Google Chrome (or any Chromium-based browsers such as Brave)
  • Does not work on Safari.
  • Turn off any VPN client on your computer. Somehow scapy does not work with VPN interfaces.
  • Because the app is not verified by Apple, you need to follow the instructions below to run IoT Inspector.

Right click on the app’s icon and select “Open”:

Screenshot of open menu

In the dialog box, click “Open”:

Screenshot of open dialog


Windows 10

Windows 10 has a built-in Linux/Debian subsystem, where you can potentially install and run IoT Inspector as if you were on Linux, although we have not tested this yet. Here is a known issue.

Sign up for the waitlist if you want to be notified when the full Windows version is ready in the coming weeks.

In the meantime, feel free to take advantage of the Linux subsystem under Windows 10 and experiment with IoT Inspector.


How to install and use IoT Inspector

Note the video contains no audio.