wose / satnogs-monitor

Terminal UI monitor for your SatNOGS ground station.
GNU General Public License v3.0
78 stars 5 forks source link

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.

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