Looking for support, wanting to talk about new features, or just hanging out? Come chat with us on Discord!
This is a spinoff of the original raspberry-noaa created by Nico - they have graciously permitted me to push this project forward with a major refactor to enhance things such as usability, style, and general updates. All original content has been preserved (as have all commits up to the point of this repo creation) to retain credit to the original creators. Please see the "Credits" section of this README for additional info and contributions from the fantastic NOAA/METEOR community!.
Wanting to give this version a go but not sure what's involved to get from the original raspberry-noaa to raspberry-noaa-v2? Check out this simple migration document that explains the few commands you need to run and retain your original data!
Finally, if you're looking for one of the cheapest ways to get started from an antenna perspective, check this out , specifically around how to use a cheap rabbit ears antenna as a dipole for capturing NOAA and Meteor images!
NOAA and Meteor-M 2 satellite imagery capture setup for the regular 64-bit Debian Bookworm & Bullseye computers and 32-bit Raspberry Pi!
As of September 2023, raspberry-noaa-v2 officially works on any Debian-based distro! This project has been developed and tested on LMDE 6 "Faye" which is similar to the original Linux Mint, although the regular Mint is based on Ubuntu, while LMDE is based directly on Debian (Linux Mint Debian Edition). It can be downloaded from here: https://mirrors.layeronline.com/linuxmint/debian/lmde-6-cinnamon-64bit.iso
See "Credits" for the awesome way this version of the framework came to be.
Want a really simple way to get up and running?
VE3ELB has been maintaining a pre-built image of Raspberry-Noaa-V2 ('RN2') over here: https://qsl.net/ve3elb/RaspiNOAA/ Setup instructions are in the PDF that is included.
There is also an image maintained by Jochen Köster DC9DD here. https://www.qsl.net/do3mla/raspberry-pi-images.html For interest, Jochen's image is the base for this off-grid system in Northern Norway! https://usradioguy.com/science/off-grid-apt-lrpt-satellite-ground-station/
There is also an image by MihajloPi maintained at: https://drive.google.com/drive/folders/1acaZ78VEROc7BWVtJ82C6qVrccA9CkR6 This image is oriented towards the general user and doesn't come with much software installed other than necessary. It was built from the minimal desktop version of the Raspberry OS Bullseye.
These images are not always up to speed with the latest code, but lots of folks find images are a great way to get started quickly!
Want to build your own, but don't want all the nitty-gritty details? Here's a quick start - if you have questions, continue reading the rest of this README or reach out by submitting an issue:
# update os localisation settings like timezone, locale and WiFi country
sudo raspi-config
# install git
sudo apt install git -y
# clone repository
cd $HOME
git clone --depth 1 https://github.com/jekhokie/raspberry-noaa-v2.git
cd raspberry-noaa-v2/
# Edit settings to match your station's location, gain and other things
nano config/settings.yml
# perform install
./install_and_upgrade.sh
Once complete, follow the migration document if you want to migrate from the original raspberry-noaa to this version 2 (keep your previous captures and make them visible).
In addition, if you have elected to run a TLS-enabled web server, see THIS LINK for some additional information on how to set up an admin login and get your Let's Encrypt signed TLS/SSL certificate.
To see what occurred during a capture event, check out the log file /var/log/raspberry-noaa-v2/output.log
.
A lot of the work done by Nico and the original Instructables poster was absolutely fantastic and simple. However, as I started using the framework, I found myself making a lot of changes but getting the changes into place in a manageable way was a bit difficult. In discussing this with Nico, we agreed that there is a logical next maturity step for this framework, so I took this on to provide a simple, one-command script and corresponding framework to manage and maintain the entire project when any changes occur, and refactored the webpanel functionality significantly to enable better feature additions in the future.
Check out the release notes for fixes and enhancements for each of the various releases since the V1 split to V2!
Also, check out THIS LINK for some screen shots of the webpanel, which is now mobile friendly!
NOTE: ONLY 32-bit OS is supported : Recommended is 'Bookworm' Release.
The original raspberry-noaa was tested on Raspberry Pi 2 and up. However, while this compatibility may have been maintained with raspberry-noaa-v2, ~~this version was developed and tested on a Raspberry Pi 4 - it has not been exhaustively tested on other variants of Raspberry Pi (but if you get it working on a version, please do submit a PR and mention it so this document can be updated!).~~, this version works on Pi 3, Pi 4 and Pi 5, and the variants of these models. If you can install Debian Bookworm or Bullseye, it will probably work.
As of September 2023, raspberry-noaa-v2 can also be installed on regular 64-bit computers running any Debian Bookworm-based distro. It has been developed and tested on LMDE 6 "Faye" which I also recommend for users coming from Windows, as it has many similarities. It can be downloaded here: https://mirrors.layeronline.com/linuxmint/debian/lmde-6-cinnamon-64bit.iso After providing Bookworm support, the recommended version for PCs running RN2 is plain old Debian Bookworm. Desktop environment (like Gnome, KDE, Cinammon, XFCE...) doesn't matter, it only has to be 64-bit Debian.
If you test with another OS - again, please submit a PR and let us know how it works out!
If you're interested in the details behind the original raspberry-noaa hardware compatibility tests, see the hardware document.
Use of this framework assumes acceptance of the wxtoimg license terms and will automatically "accept" the terms as part of the installation. You MUST review the license prior to installing this framework, which can be viewed under the "Terms and Conditions" section of the wxtoimg manual. If you disagree with the WXtoImg terms, please do not install or use this framework.
Below are some prerequisites steps and considerations before installing this software:
sudo raspi-config
command, updating
"5 Localisation Options -> L1 Locale" and "5 Localisation Options -> L2 Timezone" settings to match your base station location for more
consistent time and language handling.sudo apt install git -y
.To install the product, and get going if you're using 64 64-bit Debian Bookworm-based computer, you first need to stop sudo from asking to enter a password. It will ensure all commands are handled well, and that our project can access superuser privileges for certain things like moving files around in the audio and image directory etc.
To achieve this, run:
echo "$USER ALL=(ALL) NOPASSWD: /bin/ls" | sudo tee -a /etc/sudoers
Then reboot the computer:
sudo reboot
The following steps are for both regular computers and Raspberry Pi:
Clone the project to the user's home directory, set up your settings, and run the install script:
# update the system
sudo apt update
sudo apt full-upgrade -y
# reboot the system
sudo reboot
# install git
sudo apt install git -y
# clone repository
cd $HOME
git clone --depth 1 https://github.com/jekhokie/raspberry-noaa-v2.git
cd raspberry-noaa-v2/
# update your settings file to match your location, gain and other setup-specific settings
nano config/settings.yml
# perform install
./install_and_upgrade.sh
Once the script completes, you can either follow the migration document (if you had previously been using raspberry-noaa on this device) or, if this is a brand new setup, just visit the webpanel and get going!
NOTE: If you have elected to run a TLS-enabled web server, see THIS LINK for some additional information on how to handle self-signed certificates when attempting to visit your webpanel and enabling auth for the admin pages.
Want to get the latest and greatest content from the GitHub master branch? Easy! Run:
git pull
inside the raspberry-noaa-v2 folder. If it complains about rhe changes to settings.yml
file, make a backup of it somewhere else on your Pi like the desktop:
mv config/settings.yml ~/Desktop
and run:
git pull
Then, open the settings file and edit it to match the settings from the previous file.
NOTE: you may notice some extra variables or some variables missing. Don't worry, that's normal as some variables have been changed by the developers (either are taken care of automatically so were removed as they are redundant now, or some new thing has been implemented, hence new variables).
If you have elected to run a TLS-enabled web server, see THIS LINK for some additional information on how to handle self-signed certificates when attempting to visit your webpanel and enabling auth for the admin pages.
There are and will be future "optional" features for this framework. Below is a list of optional capabilities that you may wish to enable/configure with links to the respective instructions:
Want to make changes to either the base station functionality or webpanel settings? Simply update the config/settings.yml
file
and re-run ./install_and_upgrade.sh
- the script will take care of the rest of the configurations!
If you're running into issues where you're not seeing imagery after passes complete or getting blank/strange images, you can check
out the troubleshooting document to try and narrow down the problem. In addition, you can inspect the log
output file in /var/log/raspberry-noaa-v2/output.log
to investigate potential errors or issues during capture events.
Still having problems? You can email MihajloPi at mihajlo.raspberrypi@gmail.com and be sure to send him the log so he can debug the errors!
The decoding model has been changed with release 3.0 to default to using satdump_live based capture via Python for both Meteor (which was previously an option) and now also for NOAA. This will open the platform up for developers to integrate alternative hardware capture than RTL-SDR.
For additional information on some of the capabilities included in this framework, see below:
The NOAA/METEOR image capture community is a group of fantastic, experienced engineers, radio operators, and tinkerers that all contributed in some way, shape, or form to the success of this repository/framework. Below are some direct contributions and call-outs to the significant efforts made:
atrm
errors on the website, and several NTP and timezone issues in PHP, general alpha and beta testing.
Pull requests are welcome! Simply follow the below pattern:
git clone
your forked repository.git checkout -b <my-branch-name>
to create a branch, replacing it with your actual branch name.git push origin <my-branch-name>
to push your branch to your forked repository.jekhokie/raspberry-noaa-v2
repository and submit a pull request using your branch from your forked repository.Make sure you keep your forked repository up to date with the upstream jekhokie/raspberry-noaa-v2
master branch as this will make
development and addressing merge conflicts MUCH easier in the long run.
Happy coding (and receiving)!