Skip to content

wose/satnogs-monitor

Repository files navigation

SatNOGS Monitor (WIP)

Screenshot

builds.sr.ht status

WIP

This is more of a proof of concept for now. I'm playing with different architectures and layouts, so expect everything to change rapidly. Feel free to open issues or find me on the SatNOGS irc channel if you have suggestions what info about your station is useful to you and should be included. There is also a corresponding forum post at the SatNOGS community forum

TODOs / planned features

Note: the list is by no means complete or in any particular order.

  • reduce API queries
  • calculate ground tracks only when a new orbit begins
  • show satellite footprint (can be toggled)
  • polar plot
  • refactor station info, obs info, etc. into separate widgets
  • detect supported colors and change palette accordingly
  • build debian package for the RPi SatNOGS image
  • visual alerts on station failure (failed obs, no heartbeats, ...)
  • rotator state
  • support multiple stations
  • theme support
  • network overview
  • GUI
  • cross platform
  • waterfall stream of current observation
  • audio stream of current observation

Dependencies

libgpredict

See libgpredict for details.

git clone https://github.com/cubehub/libgpredict.git
cd libgpredict
mkdir build
cd build
cmake ../
make
make install
sudo ldconfig # for linux

Rust

Use your distribution package management to install rust or rustup if possible. See Install Rust.

rustup install stable

A terminal

While other terminals will be supported in the future, the screenshot was taken using alacritty with the Lucy Tewi font. Any nerd-fonts font should work as well. You'll need a terminal emulator which supports trur colors for the waterfall widget to look nice.

Check the wiki for infos on other terminals with and without Xorg.

Building

git clone https://github.com/wose/satnogs-monitor.git
cd satnogs-monitor/monitor
mkdir ~/.config/satnogs-monitor
cp examples/config.toml ~/.config/satnogs-monitor/
edit ~/.config/satnogs-monitor/config.toml
cargo run --release

The config file is optional, you can also provide stations with the -s parameter. At least one station has to be provided by either a config file or the command line.

cargo run --release -- -s 175 -s 227

Keys

Key Description
f toggle satellite footprint
l toggle log window
\t next station
q, ctrl-c quit

Docker

Building the docker container

docker build -t satnogs-monitor:latest .

Running

docker run -it --rm -e STATION_ID=1492 satnogs-monitor:latest