PHD2Alarms is a complimentary program for
PHD2, a program used by astro-imagers to track a guide star.
PHD2Alarms connects to a running PHD2 program via your network and can
be configured to alarm for a loss of guiding, alarm for a loss of
connection to the PHD2 program, or to alarm at a specified time.
Alarms can produce an audio output and send an email to your mailbox or
to a text message forwarding address. There are several alarm sounds
included with the program but you can use just about any audio file
as your alarm sound.
PHD2Alarms is written in Java and will run on Windows, MAC, or Linux
computers. The current version requires Java 11 or later and JavaFX11
SDK or later for best performance. I suggest installing Liberica Full
SDK from Bellsoft. Using the
Liberica Java with JavaFX requires no additional software and is the
simplest to use.
Program installation is simple, just download and save the
PHD2Alarms.jar file, the javax.mail-1.6.5.jar, and the
javax.activation-1.2.1.jar file to the same directory. If your Java
implementation doesn't have JavaFX you will also need the mp3plugin.jar
file for minimal MP3 support. The PHD2ServerSimulator.jar is a program
used to simulate a PHD2 program for testing the PHD2Alarms program and
you may use that for your own setup and testing of the PHD2Alarms
To run the program with the Liberica Full JDK, open a command prompt
Java -jar PHD2Alarms.jar
To run the program without JavaFX, open a command prompt and type:
java -jar PHD2Alarms.jar nojavafx
You may also create a link or a shortcut to the PHD2Alarms.jar file to
run the program from your desktop. The program prints a continuous
log to STDOUT and this may be saved for debugging purposes. Should you
identify a bug, the log output would be very helpful in correcting it.
Program setup instructions are found by clicking the Help ->
If you have any questions, comments, or bugs to report, please email me
at phd2alarms at knutejohnson dot com.
The Fine Print
You may download, copy, and use this software as you wish. I provide
no warranty whatsoever and you accept all risk of use up to and
including the risk of nuclear detonation as unlikely as that may be.