SatNOGS Monitor - Revision history

Lange: Update install and build process to ci-based prebuilt packages

2025-09-22T11:52:55Z

Update install and build process to ci-based prebuilt packages

Lange: Update build process and general information

2025-07-15T10:07:26Z

Update build process and general information

Michael1: /* Running it */ Added default number of orbits (3).

2021-02-13T01:38:29Z

‎Running it: Added default number of orbits (3).

Wose: Update install Instructions for 0.4.1 amd64

2020-04-29T20:52:56Z

Update install Instructions for 0.4.1 amd64

Wose: Update install Instructions for 0.4.1

2020-04-29T20:52:16Z

Update install Instructions for 0.4.1

Wose: Update install infos for version 0.4.0

2020-04-13T10:35:31Z

Update install infos for version 0.4.0

Matburnham: Add -p to mkdir so it works

2020-04-02T11:13:34Z

Add -p to mkdir so it works

Jebba: category fix

2020-01-19T22:44:29Z

category fix

Jebba: categories

2020-01-19T22:43:55Z

Alexcj2802: Added a link to the creator's forked version of yaft, which uses the Lucy Tewi font by default. https://github.com/wose/yaft

2020-01-04T10:50:44Z

Added a link to the creator's forked version of yaft, which uses the Lucy Tewi font by default. https://github.com/wose/yaft

@@ Line 6: / Line 6: @@
 ==Installation==
-===Dependencies===
+Since version 4.3-pre, there are debian packages available for simple installation.
-Nonetheless, some dependencies are left:
+# Copy the download link Debian package matching your CPU architecture from '''release page'''[https://github.com/wose/satnogs-monitor/releases]
   sudo apt-get install libglib2.0-dev cmake build-essential git
-===Raspberry Pi (armhf)===
+ git clone --recursive https://github.com/wose/satnogs-monitor.git
-You can run the SatNOGS Monitor on the same Raspberry Pi as your ground station. You can build the monitor from source (see [#Hacking]) or use the prebuild Raspbian package.
+ cd satnogs-monitor/monitor
 You can then run the monitor over any ssh connection to your ground station or view it directly on a display attached to your RPi. See [https://community.libre.space/t/stegoboard-satnogs-ground-station/4640 this thread] for some inspiration.
 The monitor makes heavy usage of braille unicode characters so make sure your terminal emulator uses a font which includes those glyphs. The screenshot at the top shows alacritty[https://github.com/jwilm/alacritty] with the tewi-font[https://github.com/lucy/tewi-font]. Take a look at nerd-fonts[https://github.com/ryanoasis/nerd-fonts/] if you're unsure about which font to use. You could also use a forked version of yaft[https://github.com/wose/yaft] created by the same person as SatNOGS Monitor, which uses the Lucy Tewi font by default.
@@ Line 94: / Line 96: @@
 '''TAB''' key will cycle through available stations while SatNOGS Monitor is running.
    [[Category:Operate]]

@@ Line 2: / Line 2: @@
 [[File:Satnogs-monitor.png|800px]]
-'''SatNOGS Monitor''' is a terminal ui to monitor your and/or other ground stations of the SatNOGS network. It is written in [https://www.rust-lang.org/ Rust] and runs on Linux and has been reported to run on MacOS[https://community.libre.space/t/satnogs-station-monitor/2802/13]. Windows is currently not supported by the underlying terminal library, but might be added at some point in the future.  '''SatNOGS Monitor''' does not need to be installed on an actual SatNOGS station computer (although there are benefits to doing so as discussed below).
+'''SatNOGS Monitor''' is a terminal ui to monitor your and/or other ground stations of the SatNOGS network. It is written in [https://www.rust-lang.org/ Rust] and runs on Linux and has been reported to run on MacOS[https://community.libre.space/t/satnogs-station-monitor/2802/13]. Windows is currently not supported by the underlying terminal library, but might be added at some point in the future.  '''SatNOGS Monitor''' does not need to be installed on an actual SatNOGS station computer (although there are benefits of doing so as discussed below).
 ==Installation==
 ===Dependencies===
-'''SatNOGS Monitor''' uses bindings to '''libgpredict'''[https://github.com/cubehub/libgpredict]. This library is not available as installable package and you'll have to build it yourself.
+'''SatNOGS Monitor''' uses bindings to '''libgpredict'''[https://github.com/cubehub/libgpredict]. From mid July 2025 on, this library will be compiled by cargo when building satnogs-monitor. Thus it does not need to be compiled manually anymore.
-====Install libgpredict dependencies====
+Nonetheless, some dependencies are left:
   sudo apt-get install libglib2.0-dev cmake build-essential git
 ===Raspberry Pi (armhf)===
-You can run the SatNOGS Monitor on the same Raspberry Pi as your ground station. You'll need to build and install libgpredict as shown above and can build the monitor from source (see [#Hacking]) or use the prebuild Raspbian package.
+You can run the SatNOGS Monitor on the same Raspberry Pi as your ground station. You can build the monitor from source (see [#Hacking]) or use the prebuild Raspbian package.
-  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.1/satnogs-monitor_0.4.1_armhf.deb
+  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.2/satnogs-monitor_0.4.2_armhf.deb
-  sudo dpkg -i satnogs-monitor_0.4.1_armhf.deb
+  sudo dpkg -i satnogs-monitor_0.4.2_armhf.deb
 You can then run the monitor over any ssh connection to your ground station or view it directly on a display attached to your RPi. See [https://community.libre.space/t/stegoboard-satnogs-ground-station/4640 this thread] for some inspiration.
 ===Linux (x86_64)===
-If you're running an Debian like distribution you can install the prebuild package after building and installing libgpredict.
+If you're running an Debian like distribution you can install the prebuild package. Please mind to install the dependencies shown above.
-  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.1/satnogs-monitor_0.4.1_amd64.deb
+  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.2/satnogs-monitor_0.4.2_amd64.deb
-  sudo dpkg -i satnogs-monitor_0.4.1_amd64.deb
+  sudo dpkg -i satnogs-monitor_0.4.2_amd64.deb
 See [#Hacking] if you're running another distribution.
@@ Line 65: / Line 56: @@
 Check the help for more command line arguments:
   $ satnogs-monitor -h
-  satnogs-monitor 0.3.1
+  satnogs-monitor 0.4.2
   Monitors the current and future jobs of SatNOGS ground stations.
@@ Line 79: / Line 70: @@
   OPTIONS:
-      -a, --api <URL>                    Sets the SatNOGS network api endpoint url
+      -a, --api <URL>                        Sets the SatNOGS network api endpoint url
-      -c, --config <FILE>                Sets custom config file
+      -c, --config <FILE>                    Sets custom config file
-          --data-path <PATH>             Enables the spectrum and waterfall plot if set to the SatNOGS
+          --data-path <PATH>
-                                        client data path (/tmp/.satnogs/data/)
+             Enables the spectrum and waterfall plot if set to the SatNOGS client data path
-          --db-max <DB>                  Sets the upper dB bound of the spectrum and waterfall plot
+             (/tmp/.satnogs/data/)
-                                        (0)
+          --db-max <DB>
-          --db-min <DB>                  Sets the lower dB bound of the spectrum and waterfall plot
+             Sets the upper dB bound of the spectrum and waterfall plot (0)
-                                        (-100)
-      -l, --local <ID>...                Adds a station running on the same machine as this monitor
+          --db-min <DB>
-                                        with this SatNOGS network id to to the list of monitored
+             Sets the lower dB bound of the spectrum and waterfall plot (-100)
-                                        stations
-      -o, --orbits <NUM>                 Sets the number of orbits plotted on the map (3)
+         --job-update-interval <SECONDS>    Polls the network for new jobs every SECONDS (600)
-          --rotctld-address <IP:PORT>    Enables rotator monitoring if set to a rotctld address
+      -l, --local <ID>...
-      -s, --station <ID>...              Adds a station with this SatNOGS network id to the list of
+             Adds a station running on the same machine as this monitor with this SatNOGS network id
-                                        monitored stations
+             to to the list of monitored stations
-          --waterfall-zoom <FACTOR>      Zooms the spectrum and waterfall plot (1.0 - 10.0)
+      -o, --orbits <NUM>                     Sets the number of orbits plotted on the map
+          --rotctld-address <IP:PORT>        Enables rotator monitoring if set to a rotctld address
 '''TAB''' key will cycle through available stations while SatNOGS Monitor is running.
 ==Hacking==
-To build the monitor from source you'll need to install the Rust. Use your package manager or follow [https://www.rust-lang.org/tools/install this site].
+To build the monitor from source you'll need to install the Rust toolchain. Use your package manager or follow [https://www.rust-lang.org/tools/install this site].
   git clone https://github.com/wose/satnogs-monitor.git

@@ Line 90: / Line 90: @@
                                          with this SatNOGS network id to to the list of monitored
                                          stations
-      -o, --orbits <NUM>                 Sets the number of orbits plotted on the map
+      -o, --orbits <NUM>                 Sets the number of orbits plotted on the map (3)
           --rotctld-address <IP:PORT>    Enables rotator monitoring if set to a rotctld address
       -s, --station <ID>...              Adds a station with this SatNOGS network id to the list of
@@ Line 108: / Line 108: @@
   edit ~/.config/satnogs-monitor/config.toml
   cargo run --release -- -s 175
- [[Category:Operate]]
+  [[Category:Software]]
- [[Category:Software]]
+  [[Category:Develop]]

@@ Line 34: / Line 34: @@
 If you're running an Debian like distribution you can install the prebuild package after building and installing libgpredict.
-  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.0/satnogs-monitor_0.4.0_amd64.deb
+  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.1/satnogs-monitor_0.4.1_amd64.deb
-  sudo dpkg -i satnogs-monitor_0.4.0_amd64.deb
+  sudo dpkg -i satnogs-monitor_0.4.1_amd64.deb
 See [#Hacking] if you're running another distribution.

@@ Line 26: / Line 26: @@
 You can run the SatNOGS Monitor on the same Raspberry Pi as your ground station. You'll need to build and install libgpredict as shown above and can build the monitor from source (see [#Hacking]) or use the prebuild Raspbian package.
-  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.0/satnogs-monitor_0.4.0_armhf.deb
+  wget https://github.com/wose/satnogs-monitor/releases/download/0.4.1/satnogs-monitor_0.4.1_armhf.deb
-  sudo dpkg -i satnogs-monitor_0.4.0_armhf.deb
+  sudo dpkg -i satnogs-monitor_0.4.1_armhf.deb
 You can then run the monitor over any ssh connection to your ground station or view it directly on a display attached to your RPi. See [https://community.libre.space/t/stegoboard-satnogs-ground-station/4640 this thread] for some inspiration.

@@ Line 40: / Line 40: @@
 ==Running it==
-The monitor makes heavy usage of braille unicode characters so make sure your terminal emulator uses a font which includes those glyphs. The screenshot at the top shows alacritty[https://github.com/jwilm/alacritty] with the tewi-font[https://github.com/lucy/tewi-font]. Take a look at nerd-fonts[https://github.com/ryanoasis/nerd-fonts/] if you're unsure about which font to use.
+The monitor makes heavy usage of braille unicode characters so make sure your terminal emulator uses a font which includes those glyphs. The screenshot at the top shows alacritty[https://github.com/jwilm/alacritty] with the tewi-font[https://github.com/lucy/tewi-font]. Take a look at nerd-fonts[https://github.com/ryanoasis/nerd-fonts/] if you're unsure about which font to use. You could also use a forked version of yaft[https://github.com/wose/yaft] created by the same person as SatNOGS Monitor, which uses the Lucy Tewi font by default.
 Monitor single station: