/iot-inspector-client

IoT Inspector Client

Primary LanguagePython

Princeton IoT Inspector

IoT Inspector is a standalone desktop app that lets you analyze your home IoT devices. It allows you to determine

  • who your IoT devices are communicating with
  • when the communication happens
  • how many bytes are sent and received over time

These features will help you identify potential problems on your home network, including

  • security problems (e.g., your camera sending out lots of traffic even when you are not using it)
  • privacy problems (e.g., your smart TV contacting advertising or tracking companies as you watch TV)
  • performance problems (e.g., identifying who is using up the most bandwidth in your home network)

For details, see https://iot-inspector.princeton.edu/. Note that much of the code is experimental at this point; contact iot-inspector@lists.cs.princeton.edu to file bug reports or seek assistance.





Getting Started on Mac OS

Tested on macOS High Sierra.

Installation

  1. Download the app: https://raw.githubusercontent.com/noise-lab/iot-inspector-client/master/v2-src/dist/start_inspector_mac.zip
  2. Double-click on the downloaded zip file to uncompress it.
  3. You'll see an uncompressed file, "start_inspector.app", as shown below:

  1. Right click on the file and click "Open" from the menu:

  1. Click the "Open" button on the dialog box:

  1. You'll be prompted to enter the admin password for IoT Inspector to work.

Running IoT Inspector

Note that the next time you run IoT Inspector, you can simply double-click on the "start_inspector.app" icon (Step 3) while skipping Steps 4 and 5.





Getting Started on Ubuntu

IoT Inspector is written in Python. With the right packages, you can technically run it yourself. We will provide detailed instructions in the coming weeks.





Getting Started on Windows

We are still working on a Windows 10 version. Stay tuned.