Aptdemod audio input is limited to 11025hz wav files. Further compatibility is planned in future updates!
Aptdemod is a C program designed to demodulate Automatic Picture Transmission (APT) radio signals from NOAA satellites stored in 11025hz wav audio files. By processing the APT signals, the program extracts and reconstructs the image data outputting a weather satellite image. This provides weather visualizations from satellite transmissions. Ideal for amateur radio enthusiasts and weather monitoring applications, this decoder leverages signal processing techniques to deliver accurate and detailed images.
The Automatic Picture Transmission (APT) protocol is an analog image transmission system developed for use on weather satellites. It was introduced in the 1960s. A user station anywhere in the world can receive local data at least twice a day from each satellite as it passes nearly overhead.
For more details, please see the additional information.
This program was developed for Linux. Additional platform compatibility will be implemented in future updates.
Aptdemod has only been tested on Debian based distros. In the future this will change, but in the mean time we recommend using Debian based distros.
sudo apt install git cmake build-essential libfftw3-dev libsndfile1-devThere are two predefined build types you can use, "Debug" and "Release". "Release" is the default if a build type is not selected when using -DCMAKE_BUILD_TYPE=build_type .
# Clone aptdemod repo
git clone https://github.com/pat8901/aptdemod.git
# Navigate to build directory
cd aptdemod/build/aptdemod-release
# Generate makefile with selected build type
cmake -DCMAKE_BUILD_TYPE=Release ../../
# Build aptdemod
make
# Run
./aptdemod -f /path/to/audio.wav# Clone aptdemod repo
git clone https://github.com/pat8901/aptdemod.git
# Navigate to build directory
cd aptdemod/build/aptdemod-debug
# Generate makefile with selected build type
cmake -DCMAKE_BUILD_TYPE=Debug ../../
# Build aptdemod
make
# Run
./aptdemod -f /path/to/audio.wav-
There are a few audio samples that can be used when testing the program for the first time. These can be found in the cloned repo under "aptdemod/documentation/samples/audio".
-
When running the program just pass the file path for one of the samples as an argument.
-
Aptdemod will output a bmp image in the same directory from which the program is called.
aptdemod [options] [arguments]-h --help: Displays help menu, providing usage and miscellaneous information.
-a --about: Displays details about the program, including license information.
-v --verbose: Provide additional program information as it runs.
-f [file] --file [file]: This option is followed by a file path argument which tells the program what audio file to process.
./aptdemod -f /path/to/audio/file/audio.wavgprof can be used to profile the debug build. For more details, please see the additional information.