kenbarbour
/
wxrx
1
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
An automated system for receiving NOAA weather satellite images via APT and publishing them to a static website
99 Commits
1 Branch
0 Tags
20 MiB
Shell 100%
 
Go to file
Ken Barbour 7ae708e1ce update documentation for usage of new schedule templates 2022-08-31 16:51:17 -04:00
lib added schedule to website 2022-08-31 16:36:45 -04:00
test added schedule to website 2022-08-31 16:36:45 -04:00
web update documentation for usage of new schedule templates 2022-08-31 16:51:17 -04:00
.gitignore ignore swap files 2022-07-02 22:09:59 -04:00
LICENSE.txt improve README and added a LICENSE 2022-07-16 17:37:41 -04:00
README.md update README; added dep and clarified cronjobs 2022-07-23 10:58:19 -04:00
completion.bash wxrx entry script 2022-01-31 19:14:26 -05:00
decode.sh add MCIR-PRECIP 2022-07-25 21:18:05 -04:00
generate_website.sh added schedule to website 2022-08-31 16:36:45 -04:00
predict_passes.sh uniform shebang 2022-07-06 19:57:31 -04:00
record.sh uniform shebang 2022-07-06 19:57:31 -04:00
run_station.sh schedule should have --after flag, not run_station 2022-07-16 12:16:15 -04:00
schedule.sh change log path 2022-07-20 19:53:51 -04:00
setup.sh uniform shebang 2022-07-06 19:57:31 -04:00
update_satellites.sh follow redirects when getting satellite data 2022-07-07 23:17:00 +01:00
wxrx.sh uniform shebang 2022-07-06 19:57:31 -04:00

README.md

WXRX - Automated Weather Satellite Image Reception

This is a collection of scripts for recording and decoding of NOAA Satellite images, and generating static web pages with the decoded image using any of the popular RTL2832U-based Software Defined Radios.

Warning: These scripts are still very much a work in progress and, in my opinion, are not ready for a major version number.

See it in action

Dependencies

  • BASH
  • wxtoimg - Note: this may require ~/.wxtoimglic and ~/.wxtoimgrc to run properly
  • predict
  • ImageMagick
  • shunit2 (for development and testing)
  • rtl_fm
  • atd
  • sox

Usage

Use wxrx help or wxrx <command> help for helptext for any of the scripts.

  • wxrx update - Fetches telemetry data from Celestrak into the current directory. Needed for predictions
  • wxrx predict - Predicts satellite passes (default: passes rising above 45 degrees within the next 24 hours)
  • wxrx record --duration {seconds} --noaa-{15|18|19} - Records a transmission from a satellite currently overhead to a wavfile
  • wxrx decode [--timestamp <unix-timestamp>] [--satellite noaa-(15|18|19)] <wavfile> - Create images for a recorded transmission using wxtoimg
  • wxrx web - Search directory tree within current directory and generates a website. Uses templates stored in WXRX_WEB_TEMPLATES (default: wxrx/web/templates; see lib/web-templates for examples), and places generated files in WXRX_WEB_PUBDIR (default wxrx/web/public)
  • wxrx pass --noaa-{15|18|19} --duration {seconds} - Handles the recording, decoding, and website generation of a single pass
  • wxrx schedule - Predicts future passes and uses atd to run wxrx pass to handle them

Example usage

  • Set wxrx/web/public as a web server document root
  • Add PWD=/srv/wxrx wxrx update && wxrx schedule as a daily cronjobs. Set PWD to a path to store data.

Further reading

github.com/nootropicdesign/wx-ground-station