Q: How do I run Shelly Scanner?
A: To run the application:
java -jar <full path>\shellyscan-x.x.x.jarQ: Why Shelly Scanner doesn't run? (1)
A: To run Shelly Scanner you need to have Java jre 17 or higher installed.
To find out if the jre is already installed on your computer and in which version you can open a terminal and execute the command: java -version; if the result is an error message probably
the jre is not installed, otherwise you can read a message containing the version.
You can download java for free from:
D: Why Shelly Scanner doesn't run? (2 - Windows)
R: Shelly Scanner should run with a simple double click on the file with the "jar" extension shellyscan-x.x.x.jar; sometimes the association between jar and jre (java runtime environment) disappears; in this case you can install the jre again or use a tool such as jarfix to restore the correct association.
D: Why Shelly Scanner doesn't run? (3 - Windows)
R: Some jdk have a bug that prevent Shelly Scanner to run on specific, and fortunately infrequent, network configurations.
In such a case executing the applicatyion with the following command: java -jar -Djava.net.preferIPv4Stack=true <full path>/shellyscan-x.x.x.jar should do the magic.
Q: Why Shelly Scanner doesn't run? (4 - OS X)
A: To run Shelly Scanner on OS X you must create a text file (ASCII) inside the folder obtained unzipping the compressed downloaded file 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-<...>;
this will allow Shelly Scanner to maintain its configuration file.
Q: Is Java (jre) already installed on my computer? Which version?
A: Write the following command on terminal: java -version; if an error occurs probably java is not installed,
otherwise you will get a message showing the current version. Shelly Scanner requires version 17 or later.
Q: Why Shelly Scanner can't find my devices (1)?
A: Give java the permissions to access the network (this request will be made only at the first run).
Q: Why Shelly Scanner can't find my devices (2 - Windows)?
A: Verify that the network is configured as "private". After changing this setting, in some cases, it is necessary to restart the operating system.
Q: Why Shelly Scanner can't find my devices (3)?
A: Your devices could not be connected to the same network to which the computer is connected.
In this case you may force the application to perform "full scan" from the configuration dialog 
(Warning: this option will be valid only at the next application run).
Alternatively, you can run the application from the terminal with the following command line: java -jar <full path>\shellyscan-x.x.x.jar -fullscan
which ignores the current configuration.
Q: Why Shelly Scanner can't find my devices (4)?
A: If the devices connect to a separate network (it is, for example, the case of a subnet dedicated to home automation devices) it is necessary to set the "scan by IP" option which, however, inhibits the discovery of some battery-powered Shellyes such as Button 1, H&T, Flood or D&W.
Q: Is Shelly Scanner source code public?
A: Yes, Shelly Scanner is distribuited under GNU General Public License v3.0; The source code is on GitHub.
Q: May I send reports of malfunctions?
A: For information, comments or reports please send messages to the following e-mail address: info@usna.it.
Shelly Scanner is free and will always be free, however you can support its development with a donation.