f0c92c76da | ||
---|---|---|
lib | ||
test | ||
web | ||
.gitignore | ||
LICENSE.txt | ||
README.md | ||
completion.bash | ||
decode.sh | ||
generate_website.sh | ||
predict_passes.sh | ||
record.sh | ||
run_station.sh | ||
schedule.sh | ||
setup.sh | ||
update_satellites.sh | ||
wxrx.sh |
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.
Dependencies
- BASH
- wxtoimg - Note: this may require
~/.wxtoimglic
and~/.wxtoimgrc
to run properly - predict
- ImageMagick
- shunit2 (for development and testing)
- rtl_fm
- atd
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 predictionswxrx 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 wavfilewxrx decode [--timestamp <unix-timestamp>] [--satellite noaa-(15|18|19)] <wavfile>
- Create images for a recorded transmission using wxtoimgwxrx web
- Search directory tree within current directory and generates a website. Uses templates stored inWXRX_WEB_TEMPLATES
(default: wxrx/web/templates; see lib/web-templates for examples), and places generated files inWXRX_WEB_PUBDIR
(default wxrx/web/public)wxrx pass --noaa-{15|18|19} --duration {seconds}
- Handles the recording, decoding, and website generation of a single passwxrx schedule
- Predicts future passes and usesatd
to runwxrx pass
to handle them
Example usage
- Set
wxrx/web/public
as a web server document root - Add
wxrx update && wxrx schedule
as a daily cronjoba