• Home
  • /
  • WXtoImg Software


We recommend the powerful software "WXtoImg" for recording and decoding weather images with our receivers.

"WXtoImg is a fully automated APT and WEFAX weather satellite (wxsat) decoder. The software supports recording, decoding, editing, and viewing on all versions of Windows, Linux, and macOS. WXtoImg supports real-time decoding, map overlays, advanced colour enhancements, 3-D images, animations, multi-pass images, projection transformation (e.g. Mercator), text overlays, automated web page creation, temperature display, GPS interfacing, wide-area composite image creation and computer control for many weather satellite receivers."
 - taken from the WXtoImg website.

Visit the WXtoImg website for more information
WXtoImg

Important Information About Kepler Data

The built-in function of WXtoImg to update Kepler data has stopped working. Please follow the instructions in the dedicated section below for a permanent fix.

Installation Notes

On Windows we strongly advise to use our pre-configured installation. If you want to use the original installation instead or you use Linux, please make sure to follow the steps below to correctly configure WXtoImg. If not configured correctly, WXtoImg will crash!

Configuring Original Installation

After starting WXtoImg for the first time, please go to Options > Active APT Satellites and uncheck NOAA 17 from the list of active satellites because this satellite has been shut down.

On the same window, change the frequencies of NOAA 18 to 137.9125 MHz and of NOAA 19 to 137.1000 MHz.

The last step is to update the Kepler data. As stated above, the internal functions of WXtoImg for updating Kepler data stopped working. You either need to update the data manually, or use one of the solutions from the section below.

Linux

On many Linux distributions Debian packages can be installed by double-clicking.
To install WXtoImg using the TAR.GZ archive instead, use the following command:

gunzip < wxtoimg-linux-amd64-2.11.2-beta.tar.gz | sudo sh -c “(cd /; tar -xvf -)”

To start the software with a graphical user interface type xwxtoimg.

We recommend to also install the ALSA Audio Mixer GUI using the command below. This makes the audio mixer available from within WXtoImg.

sudo apt-get install alsamixergui

Next, please follow the steps above under "Configuring Original Installation" to correctly configure WXtoImg.

macOS

WXtoImg for macOS is a 32-Bit application and therefore won't run on macOS 10.15 Catalina or newer.


WXtoImg

Correct configuration of the Active APT Satellites options.

Updating Kepler Data

WXtoImg's built-in function to update Kepler data no longer works, after the source of the data (celestrak.org) changed its top-level-domain. Since up-to-date Kepler data are imperative for the application to function properly, one of the permanent fixes presented below must be implemented to restore this functionality.

Keplers Updater for WXtoImg

Keplers Updater for WXtoImg is a tool we developed to replace the built-in function of WXtoImg to update Kepler data. It doesn't require any setup and is easy to use with a graphical user interface. It is compatible with Windows 7 and newer. Keplers Updater for WXtoImg is already included in our pre-configured installation.

To start the tool, unzip the file and double-click on Keplers-Updater.exe. To update the Kepler data, just press the Update Kepler Data button. The latest Kepler data will be downloaded and saved in the correct location. A more detailed description of the tool can be found on GitHub.


Keplers Updater UI

Keplers Updater for WXtoImg

Simplified Version, 32-Bit Compatible

We also created a simplified version of Keplers Updater that is compatible with Windows 32-bit, too. Use setup.exe to install the tool. It requires .NET Desktop Runtime 6.0.7 to run, which will be installed automatically.


Keplers Updater UI

Simplified version of Keplers Updater


Other Solutions

Using a Proxy Server

A solution to restore the built-in update function of WXtoImg is to use a simple proxy server that is able to handle the HTTP redirects of the data source. Such a proxy, wxtoproxy is available on GitHub and was made for WXtoImg. You can download wxtoproxy for Windows from this link:

Save wxtoproxy.exe in your WXtoImg installation directory. By default, this is:

C:\Program Files (x86)\WXtoImg\

From this point on, you must start WXtoImg by starting wxtoproxy.exe instead of using xwxtoimg.exe or the WXtoImg desktop shortcut. In WXtoImg, go to Options > Internet Options, enable Use Proxy Server and type 127.0.0.1 into Proxy Host and 8080 into Proxy Port. You don't need to do this last step, if you use our pre-configured installer. Now, the built-in function of WXtoImg to update Kepler data should work again.

You must not close the console window that opens with wxtoproxy.exe! Any messages saying 404 - Not found are expected and can be ignored.

If you are still using Windows XP, download wxtoproxy.exe with this link.


WXtoImg Proxy Settings

Configuration of the Internet Options for wxtoproxy.

Linux Command

On Linux, the following command can be used to download the latest Kepler data:

sudo wget -O /usr/local/lib/wx/tle/weather.txt https://celestrak.org/NORAD/elements/weather.txt

Manual Update

You can update the Kepler data manually by right-clicking the link at the top right of this page and choosing Save Target/Link As. Now save the weather.txt file either in the WXtoImg installation directory or in the configuration directory. The default installation directory on Windows is:

C:\Program Files (x86)\WXtoImg\

The configuration directory on Windows, which is hidden by default, is:

C:\Users\[your username]\AppData\Roaming\WXtoImg\