Shelly Scanner

Shelly Scanner is an application aimed at monitoring and managing most of the IoT devices of the Shelly family. It provides an instant overview of all devices connected to the same network to which the computer is connected. The dashboard provides information such as wi-fi signal strength, cloud status, time elapsed since the last reboot (uptime), internal temperature (for devices providing it) and meters values; it also allows to control the devices. Other useful functions, such as backup and restore of devices configuration, can easily be accessed through the toolbar.

Appearance may change depending on version and OS.
Firmware update dialog.
Device details (json).

The use of Shelly Scanner should be quite intuitive however there are some details that may be not clear at a first glance, so I have prepared a synthetic manual.

Currenlty the following devices are supported:

  • Shelly 1 (also with addon)
  • Shelly 1L
  • Shelly 1pm (also with addon)
  • Shelly 2
  • Shelly 2.5
  • Shelly RGBW2
  • Shelly Dimmer (1/2)
  • Shelly I3
  • Shelly EM
  • Shelly 3EM
  • Shelly UNI
  • Shelly Plug
  • Shelly Plug S
  • Shelly Bulb
  • Shelly Duo
  • Shelly Duo RGB
  • Button 1
  • Motion (1/2)
  • Shelly TRV (restore incomplete)
  • Shelly D&W (1/2)
  • Shelly Flood
  • Shelly H&T
  • Shelly Plus 1 (also with addon)
  • Shelly Plus 1PM (also with addon)
  • Shelly Plus 2PM (also with addon)
  • Shelly Plus i4 (also with addon)
  • Shelly Plus plug IT
  • Shelly Plus plug US
  • Plug Plus S
  • Plug UK
  • Wall Dimmer
  • Plus H&T
  • Shelly Smoke
  • Shelly mini 1 gen2
  • Shelly mini 1pm gen2 (partial)
  • Shelly mini pm gen2 (partial)
  • Shelly Pro 1
  • Shelly Pro 1PM
  • Shelly Pro 2
  • Shelly Pro 2PM
  • Shelly Pro 3 (partial)
  • Shelly Pro 4PM
  • Shelly mini 1 gen3 (partial)
  • Shelly mini 1pm gen3 (partial)
  • Shelly mini pm gen3 (partial)
  • H&T gen3 (partial)
Also devices not specifically supported are found and managed, albeit partially, by the application.

Devices, which are found and identified automatically, must be connected to the same local area network (LAN) to which the computer running the application is connected.

Since the application communicates with the devices through the API exposed and documented by the manufacturer, it cannot damage them in any way.
About Backup/Restore of the devices configuration, it should be noted that not all parameters are restored; moreover is not guaranteed that the restore process does not alter parameters in an unforeseen way (I perform plenty of tests on my devices but the variants are probably many thousands).

The application may not fully work with devices whose firmware is not updated.

Warning: java jre version 17 or higher must be installed.
You can download the jre for free from here: or here you find a very light jre version: Eclipse Temurin jre.

To run the application (compressed version):

  1. download the zip file from this page;
  2. unpack the file on the disk;
  3. Run (double click) the shellyscan-x.x.x.jar file or open a terminal window and digit the following command:
    java -jar <full path>\shellyscan-x.x.x.jar
    To run on OS X you must create a text file (ASCII) inside the folder obtained after step 2 containing the following line java -jar /Applications/ShellyScanApp/shellyscan-x.x.x.jar, make the file executable running the command chmod 755 <created file name> from the terminal. Move the folder to Applications and then run the created file with any permissions the OS may require. In some cases you also need to authorize the application to write to the disk: System Settings -> Privacy & Security -> Full Disk Access and add shellyscan-<...>
If the above described procedure doesn't work please consult the FAQ page.

For information, comments or reports please send messages to the following e-mail address:

Shelly Scanner is free and will always be free, however you can support its development with a donation.