PHD2Alarms

PHD2Alarms Image

Program Description

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 and JavaFX11 SDK for best performance. I suggest installing OpenJDK11 from here and OpenJFX11 SDK from here. See this page for how to configure the necessary environment variables.

Installation

Program installation is simple, just download and save the PHD2Alarms.jar file, the javax.mail.jar and the javax.activation.jar file to the same directory. If your Java implementation doesn't have JavaFX you will also need the mp3plugin.jar file. 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 program.

Operation

To run the program in Windows, open a Command Prompt and type:

java --module-path %PATH_TO_FX% --add-modules=javafx.media,javafx.swing -jar PHD2Alarms.jar

To run the program under Linux, open a Terminal and type:

java --module-path $PATH_TO_FX --add-modules=javafx.media,javafx.swing -jar PHD2Alarms.jar

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 -> Directions menu.

Feedback

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.