Skip to content
📡 Receive weather images from geostationary meteorological satellite GK-2A (128.2˚E).
Python Other
  1. Python 99.9%
  2. Other 0.1%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
tools
.gitignore
CHANGELOG.md
README.md
ccsds.py
demuxer.py
xrit-rx.bat
xrit-rx.ini
xrit-rx.py
xrit-rx.sh

README.md

📡 xrit-rx - LRIT Downlink Processor

xrit-rx is a LRIT packet demultiplexer and xRIT file processor for geostationary meteorological satellite GK-2A (GEO-KOMPSAT-2A). It takes input in the form of VCDUs (Virtual Channel Data Units) from software such as goesrecv (original) by Pieter Noordhuis, or xritdecoder by Lucas Teske.

Demultiplexed data is output as .lrit files which can be processed into images such as the ones below.

GK-2A Wavelengths

Getting Started

The RTL-SDR Blog has written a thorough guide for setting up the hardware and software required to receive imagery from GOES-16/17 and GK-2A. Once you are able to receive the GK-2A LRIT downlink with goesrecv, you can begin installing and configuring xrit-rx.

Installing xrit-rx

xrit-rx requires Python packages pycryptodome and pillow to be installed using the following command:

pip3 install pycryptodome pillow

Once these packages are installed, download the latest version of xrit-rx (direct) from the Releases page.

Configuring xrit-rx

All user-configurable options are found in the xrit-rx.ini file. The default configuration will work for most situations.

If xrit-rx is not running on the same device as goesrecv, the ip option will need to be updated with the IP address of the device running goesrecv.

List of options

rx section

Setting Description Options Default
spacecraft Name of spacecraft being received GK-2A GK-2A
mode Type of downlink being received lrit lrit
input Input source goesrecv or osp goesrecv
keys Path to decryption key file Absolute or relative file path EncryptionKeyMessage.bin.dec

output section

Setting Description Options Default
path Root output path for .lrit files Absolute or relative file path "received"
channel_blacklist List of virtual channels to ignore
Can be multiple channels (e.g. 4,5)
0: Full Disk
4: Alpha-numeric Text
5: Additional Data
none

goesrecv section

Setting Description Options Default
ip IP Address of a Raspberry Pi running goesrecv Any IPv4 address 127.0.0.1
vchan Output port of goesrecv Any TCP port number 5004

osp section

Setting Description Options Default
ip IP Address of a PC running Open Satellite Project xritdecoder Any IPv4 address 127.0.0.1
vchan Output port of Open Satellite Project xritdecoder Any TCP port number 5001

Acknowledgments

You can’t perform that action at this time.