Merge Version 1.5

README.md

@@ -28,8 +28,9 @@ Vitality GOES has the following features:
 
 * It is easily usable by anyone with no knowledge of radio, satellites, or programming once set up by a ground station technician (you!).
 * Vitality GOES presents all full-disk images, and mesoscale imagery, and more in a user friendly and easily navigatable way.
-* Current weather conditions, forecasts, watches, and warnings from the GOES-16/18 HRIT/EMWIN data feed are presented to the user in a way that is appealing and easy to read. There is no need to parse through data for other locations: your configured location's data is the only thing you're shown. For a writeup on the EMWIN data Vitality GOES pulls and how it's used, see [here](docs/used-emwin-data.md).
-* Vitality GOES is able to monitor the status of the underlying goestools/SatDump stack, including systems temps, error correction rates, and packet drop rates.
+* Current weather conditions, forecasts, watches, and warnings from the GOES-16/18 HRIT/EMWIN data feed are presented to the user in a way that is appealing and easy to read. There is no need to parse through data for other locations: your configured location's data is the only thing you're shown.
+* Discover and browse additional data from the EMWIN data feed. For a writeup on the EMWIN data Vitality GOES pulls and how it's used, see [here](docs/used-emwin-data.md).
+* Monitor the status of the underlying goestools/SatDump stack, including systems temps, error correction rates, and packet drop rates.
 
 Sample configurations are provided for the following satellite/station setups:
 
@@ -52,6 +53,8 @@ You need to set up a satellite dish and point it at the satellite of your choice
 
 It is recommended that you host Vitality GOES on your ground station itself for the most up-to-date information and to simplify setup/maintenance. If you choose, it can be hosted on another machine if you have a sync process set up between the ground station and the Vitality GOES server. *Syncing received images from another machine is outside the scope of Vitality GOES.*
 
+
+
 It is also recommended that you use a Debian-based Linux distro to host the Vitality GOES server. Something like Raspberry Pi OS, Ubuntu, or Debian is preferred. If you host it on Windows, make sure your satellite data is on an NTFS drive.
 
 If you enable the secondary scripts, you may need more processing power than a low-end machine (like a Raspberry Pi) can provide. You may need to offload video rendering tasks to another machine or upgrade your server to something beefier. I'm using a laptop with a 4th generation Core i5 processor, and it has more than enough power to run goestools, Vitality GOES, and all secondary scripts.
@@ -78,7 +81,12 @@ satdump live goes_hrit F:\path\to\satdumprepo --source rtlsdr --samplerate 2.4e6
 The `http_server` part is optional and is only needed to provide decoder/demodulator statistics to Vitality GOES. For more information, see [the config documentation](/docs/config.md#general).
 
 ### Vitality GOES Dependencies
-Vitality GOES itself is a set of PHP, HTML, JavaScript, and CSS files. As such, it needs to be hosted on a web server stack. For this readme, I'm going to assume you're not running another web server on the same machine.
+Vitality GOES needs to be hosted on a web server stack. Recommended software versions:
+
+ - **Web Server:** Apache2
+ - **PHP Version:** PHP 8.0+ (PHP 7.4 is supported)
+
+For this readme, I'm going to assume you're not running another web server on the same machine.
 
 ---
 
@@ -89,6 +97,28 @@ Assuming you're on a Debian/Ubuntu-based server, the following commands should i
 sudo apt update
 sudo apt upgrade
 sudo apt install apache2 php libapache2-mod-php
+sudo a2enmod rewrite
+sudo systemctl restart apache2
+```
+
+You may also need to enable .htaccess files in Apache2 for all functionality to work. To do so, edit /etc/apache2/apache2.conf as root and update this section:
+
+```apache
+<Directory /var/www/>
+        Options Indexes FollowSymLinks
+        AllowOverride None
+        Require all granted
+</Directory>
+```
+
+to this:
+
+```apache
+<Directory /var/www/>
+        Options -Indexes
+        AllowOverride All
+        Require all granted
+</Directory>
 ```
 
 #### Windows

configs/goestools-goes16/config.ini

@@ -4,6 +4,8 @@
 ;graphiteAPI	= http://127.0.0.1:8080/render/
 ;adminPath = /path/to/goestoolsdata/text
 emwinPath = /path/to/goestoolsdata/emwin
+fastEmwin = false
+spaceWeatherAlerts = false
 showSysInfo = true
 debug = false
 
@@ -27,3 +29,8 @@ city = COLLEGE PARK
 lat = 39.02
 lon = -76.98
 timezone = America/New_York
+
+[otheremwin]
+ini = otheremwin.ini
+allowUserLoader = true
+maxUserFiles = 1000

configs/goestools-goes16/otheremwin.ini

@@ -0,0 +1,29 @@
+[ADMSDM]
+identifier = "ADMSDM.*"
+title = "SDM OPS Status Messages"
+format = paragraph
+truncate = 3
+
+[SPACE]
+identifier = "(ALT|WAT).*"
+title = "Space Weather Messages"
+format = paragraph
+truncate = 3
+
+[RADAR]
+identifier = "FTM.*"
+title = "Radar Outages"
+format = paragraph
+truncate = 0
+
+[ADMINALERT]
+identifier = "ADA.*"
+title = "EMWIN Admin Alerts"
+format = paragraph
+truncate = 0
+
+[ADMINREGIONAL]
+identifier = "ADR.*"
+title = "EMWIN Regional Admin Message"
+format = paragraph
+truncate = 4

configs/goestools-goes18/config.ini

@@ -4,6 +4,8 @@
 ;graphiteAPI	= http://127.0.0.1:8080/render/
 ;adminPath = /path/to/goestoolsdata/text
 emwinPath = /path/to/goestoolsdata/emwin
+fastEmwin = false
+spaceWeatherAlerts = false
 showSysInfo = true
 debug = false
 
@@ -27,3 +29,8 @@ city = SANTA ROSA
 lat = 38.44
 lon = -122.71
 timezone = America/Los_Angeles
+
+[otheremwin]
+ini = otheremwin.ini
+allowUserLoader = true
+maxUserFiles = 1000

configs/goestools-goes18/otheremwin.ini

@@ -0,0 +1,29 @@
+[ADMSDM]
+identifier = "ADMSDM.*"
+title = "SDM OPS Status Messages"
+format = paragraph
+truncate = 3
+
+[SPACE]
+identifier = "(ALT|WAT).*"
+title = "Space Weather Messages"
+format = paragraph
+truncate = 3
+
+[RADAR]
+identifier = "FTM.*"
+title = "Radar Outages"
+format = paragraph
+truncate = 0
+
+[ADMINALERT]
+identifier = "ADA.*"
+title = "EMWIN Admin Alerts"
+format = paragraph
+truncate = 0
+
+[ADMINREGIONAL]
+identifier = "ADR.*"
+title = "EMWIN Regional Admin Message"
+format = paragraph
+truncate = 4

configs/satdump-ews-g1/gvar.ini

@@ -31,3 +31,4 @@ filter = "_4_"
 path = "{EWSG1}\IMAGE\GOES-13\"
 title = "EWS-G1 - Band 5 - Dirty Longwave IR"
 filter = "_5_"
+

configs/satdump-goes16/abi.ini

@@ -6,51 +6,61 @@ icon = globe-americas
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Color"
 filter = "_FC_"
+fast = true
 ;videoPath = GOES16FalseColor.mp4
 
 [fdch02_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 2 (Red)"
 filter = "_2_"
+fast = true
 ;videoPath = GOES16Ch2.mp4
 
 [fdch07_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 7 (Shortwave IR)"
 filter = "_7_"
+fast = true
 ;videoPath = GOES16Ch7.mp4
 
 [fdch08_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 8 (Upper Troposphere)"
 filter = "_8_"
+fast = true
 ;videoPath = GOES16Ch8.mp4
 
 [fdch09_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 9 (Mid Troposphere)"
 filter = "_9_"
+fast = true
 ;videoPath = GOES16Ch9.mp4
 
 [fdch13_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 13 (Clean Longwave IR)"
 filter = "_13_"
+fast = true
 ;videoPath = GOES16Ch13.mp4
 
 [fdch14_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 14 (Longwave IR)"
 filter = "_14_"
+fast = true
 ;videoPath = GOES16Ch14.mp4
 
 [fdch15_16]
 path = "{GOES16}\IMAGES\GOES-16\Full Disk"
 title = "GOES 16 - Channel 15 (Dirty Longwave IR)"
 filter = "_15_"
+fast = true
 ;videoPath = GOES16Ch15.mp4
 
 [fd_18]
 path = "{GOES16}\IMAGES\GOES-18\Full Disk"
 title = "GOES 18 - Channel 13 (Relay)"
 filter = "_13_"
+fast = true
+

configs/satdump-goes16/config.ini

@@ -4,6 +4,8 @@
 ;satdumpAPI = http://127.0.0.1:8080/
 adminPath = "F:\path\to\satdumpdata\Admin Messages"
 emwinPath = "F:\path\to\satdumpdata\EMWIN"
+fastEmwin = true
+spaceWeatherAlerts = false
 showSysInfo = true
 debug = false
 
@@ -26,3 +28,8 @@ city = COLLEGE PARK
 lat = 39.02
 lon = -76.98
 timezone = America/New_York
+
+[otheremwin]
+ini = otheremwin.ini
+allowUserLoader = true
+maxUserFiles = 1000