autowx2 is a set of programs and scripts for schedule satellite and ground recordings with SDR dongle. Bundled plugins include scripts for processing weather APT images from NOAA or METEOR satellites, ISS voice communication recordings and some others.
This is a rewritten and fine-tuned version of tools for the automatic weather satellite images capturing. Most directly it bases on cyber-atomus' autowx and my fork of autowx. The main differences between this project autowx2 and previously created tools:
autowx2 was tested and successfully applied to schedule recordings of:
autowx2 can be easily configured to do other useful things (with SDR dongle) while waiting for the next scheduled transmissions. Tested and available "plugins" include:
dump1090
, heatmap plottingThese scripts may be used by the autowx2 in the free time, e.g., to track airplanes, capture APRS signals etc:
dump1090
for tracking airplanes), any broadband antenna should be good./etc/udev/rules.d/20.rtlsdr.rules
:SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2838", GROUP="adm", MODE="0666", SYMLINK+="rtl_sdr"
dvb_usb_rtl28xxu
module:
echo "blacklist dvb_usb_rtl28xxu" >> /etc/modprobe.d/rtl-sdr-blacklist.conf
:warning: Tested for x86, amd64 and Raspberry Pi
git clone --depth 1 git@github.com:filipsPL/autowx2.git
git clone --depth 1 https://github.com/filipsPL/autowx2.git
install.sh
, modify if needed. In most cases, it should work out of the box (for debian and debian-like systems; tested on debian, ubuntu, mint and travis debian like linux). Modify wxtoimg section to fetch sources that matches your architecture.
pip
or conda
depending on your preferences of installing python packagesbash install.sh
. :warning: use at your own risk!autowx2_conf.py
bin/update-keps.sh
script to it, eg:0 4 * * * path/to/autowx2/bin/update-keps.sh 1> /dev/null 2>/dev/null
autowx2.py
, wait for the next transit and marvel at the beautiful images (or other recordings)The main program to do all calculation, pass predictions and launch modules.
autowx2.py - the main program, the governor of all other programs and scripts
autowx2_conf.py - the config file
The config file of the main program, may be used also by the decoding modules. It is used by te noaa module.
satellitesData - the dictionary (in the python style) of satellites to be observed and processed (eg., weather satellites) OR fixed times for recordings (eg., listening to the WeatherFax transmissions).
freq
- the frequency to listen atprocessWith
- the path to the script/module to run during the transitpriority
- priority of the recording (if two or more overlaps); the lower number - the higher priorityfreq
- the frequency to listen atprocessWith
- the path to the script/module to runfixedTime
- the fixed time of recording in the cron style.fixedDuration
- the duration of the recordingpriority
- priority of the recording (if two or more overlaps); the lower number - the higher prioritySample satellitesData
dictionary:
satellitesData = {
'NOAA-18': {
'freq': '137912500',
'processWith': 'modules/noaa/noaa.sh',
'priority': 1},
'NOAA-15': {
'freq': '137620000',
'processWith': 'modules/noaa/noaa.sh',
'priority': 1},
'NOAA-19': {
'freq': '137100000',
'processWith': 'modules/noaa/noaa.sh',
'priority': 1},
'ISS': {
# voice channel
'freq': '145800000',
'processWith': 'modules/iss/iss_voice_mp3.sh',
'priority': 5},
'PR3_NEWS': {
'freq': '98988000',
'processWith': 'modules/fm/fm.sh',
'fixedTime': '0 7-23 * * *',
'fixedDuration': 300,
'priority': 2},
'LILACSAT-1': {
'freq': '436510000',
'processWith': 'modules/iss/iss_voice_mp3.sh',
'priority': 3},
'Radiosonde': { # twice a day watch for meteo balloons
'freq': '98796500',
'processWith': 'modules/radiosonde/run_radiosonde_scanner.sh',
'fixedTime': '20 0,12 * * *',
'fixedDuration': 12000,
'priority': 1},
}
A utility to generate transit plan for the next few hours. Two elements are generated:
gen-static-page.sh
to autowx2/var/www/table.html
):Various auxiliary programs.
aprs.sh - aprs script to listen to and decode APRS data; to be run in free time
pymultimonaprs.sh - aprs iGate launcher (pymultimonaprs must be installed)
kalibruj_initial.sh - calibrating script - initialization
kalibruj.sh - calibrating script - getting the drift
update-keps.sh - keplers updated; can/should be run from cron
crontab/ - proposal of scripts to be run periodicaly
Modules/plugins to capture various types of data. Can be customized by any type of script (here bash scripts were used in most cases).
fm - sample module to record FM radio to mp3 file
iss - module for capturing voice data from ISS and others. Tested and works for ISS :tada:
noaa - module for capturing weather data from NOAA satellites (see below)
radiosonde - module for running the radiosonde scanner (to be installed separately)
meteor-m2 - module for running the meteor m2 capturing and processing programm
Module for capturing weather data from NOAA satellites.
noaa.sh - the main module file (bash) - launches below files:
noaa_record.sh - recordinf of a sound via rtl_fm
noaa_process.sh - processing of the recorded wav file, generates maps etc.
_loop_noaa_gallery.sh - generate gallery
noaa_gallery.sh - generate gallery
tests - directory with a test data
Generic module to capture various audio and raw packages (e.g., from ISS, but not only):
iss_voice_iq.sh - record audio in iq/raw format
iss_voice_mp3.sh - record audio in mp3 format
iss_voice_wav.sh - record audio in wav format
Variable data.
dongleshift.txt - current dongle shift
nextpass.* - list and plot of the next passes
tle/ - directory with tle data
flask/ - flask webserver stuff (see flask documentation):
static/ - css, js
templates/ - html template(s)
www/ - stuff for static webpages; templates and output data
css/ - css, js
Modules may generate static webpages - snippets (see: noaa noaa_gallery.sh
script). Then, the bin/gen-static-page.sh
script collects these snippets and build a static webpage with all the data.
The web page is generated into /var/www/
(the default location).
autowx2 is equipped with a simple flask webserver showing what is going on - displaying current logs (with some limitations, i.e., not showing logs of external programs - solution needed) and updated pass list.
The default address is http://localhost:5010/
(the port may be changed in the config file via webInterfacePort
variable)
If you have a working and publically accesible autowx2 instance, please share with us!