v1.5.3

What's Changed

• Added example configs for SatDump 1.2.1 composite names, and its new L2/non-cmip processing. You must be on the yet-to-be-released SatDump 1.2.1, or the latest nightly, for the new configs to work. Note: there is no code change here - if you only want to add SatDump's new composites to Vitality GOES, you only need to look at the new example configs.
• Added support for Special Weather Statements.
• Fixed all SatDump example configs to work on Linux.
• Fixed multiple bugs in displaying the current weather. However, there is more to do here!
• Fix a few bugs in the video rendering scripts
• Added support for displaying timelapse videos from a URL instead of the videos/ folder
• Fixed other miscellaneous bugs

Full Changelog: v1.5.2...v1.5.3

v1.5.2

What's Changed

• Added support for SatDump 1.2.0. SatDump has changed its folder structure entirely for geostationary satellites. If you are updating from a previous version, you will need to update abi.ini and meso.ini to work with the new layout! All sample configs have been updated, and include many of the new GOES-16/18 composites.
• Added CreateVideos-ABI-SatDump.sh for Linux, and CreateVideos-ABI-SatDump.ps1 and CreateVideos-EMWIN.ps1 for Windows. Please review the scripts documentation if you would like to use any of these scripts to render videos.
• Added example config for GK-2A HRIT with SatDump
• Fix support for unofficial RWR reports

Full Changelog: v1.5.1...v1.5.2

v1.5.1

What's Changed

• Fixed a bug where an error would be shown if you used a port other than 80 or 443 (#53)
• Fixed an error that can occur on some Dust Advisories
• Added support for files from XRIT Decoder (testers welcome!)
• Update Home Assistant template for 2023.9
• Other small changes

Full Changelog: v1.5...v1.5.1

v1.5

What's Changed

• The "Other EMWIN" screen is now customizable by the server administrator! Any EMWIN text products can now be displayed on the EMWIN screen. For more on how to configure it, see the configuration documentation.
  
• Additionally, the Other EMWIN screen now has an Additional Data Loader: The data loader makes it easy for end users to browse all EMWIN text products by their product identifier, originator, and state of origin without changing the server configuration. This feature can be limited by the system administrator.
  
• Add feature to display K-Index 5+ space weather events as weather warnings. This can be configured by the system administrator.
  
• Implement custom URLs for each section of Vitality GOES, instead of using one URL for everything like before.
  • This enables you to link to a specific page within your system
  • Also makes the browser forward/back buttons work within Vitality GOES
• Increased optimization to significantly improve performance: On Windows Servers, some pages load 40% faster if you're running PHP 8.2.
  • On my Windows test bed, 24 hours of EMWIN data now takes under 6 seconds to load (was around 10 seconds).
  • Other data (up to several weeks) load in under 1 second.
  • Performance increases on Linux servers are less drastic, but still measurable.
  • Old versions of PHP perform about the same, so update today!
• Implemented fast file parser: In addition to Windows server performance improvements, if your data is not separated into dated sub-folders, you can now turn on a fast file parser to significantly increase web app performance.
  • On a test Linux server with 24 hours of EMWIN data, Current Weather queries went from 300ms to 80ms
  • On a test Windows server with 24 hours of EMWIN data, Current Weather queries went from 6 seconds to 80ms
  • Similarly, a test Windows server with 1.5 years of full disk data (25,557 images) can now be queried in 125ms
  • It is off by default for compatibility, but can be turned on by the system administrator.
• Add ability to parse EMWIN text files when there is more than one message per file
• Add ability to install Vitality GOES into a subfolder of an existing web server (for advanced users)
• Added interpolation to CreateVideos-ABI.sh and fixed bug where it would crash with non-even height photos
• Multiple additional bug fixes and optimizations

Preparing your system for 1.5

This update does not have any completely "breaking changes," but things will work best if your system is configured as follows:

• Apache's mod_rewrite and .htaccess parsing should be enabled for Vitality GOES 1.5+

  • Without this, the browser refresh button may not work correctly.
  • Most Windows servers (including XAMPP) have this enabled by default. No action is needed on your part.
  • On Linux, do the following to make sure mod_rewrite and .htaccess parsing is enabled:
    • Run this command: sudo a2enmod rewrite && sudo systemctl restart apache2
    • Edit /etc/apache2/apache2.conf as root and update this section:

      <Directory /var/www/>
          Options Indexes FollowSymLinks
          AllowOverride None
          Require all granted
      </Directory>

      to this (the important bit is "AllowOverride All"):

      <Directory /var/www/>
          Options -Indexes
          AllowOverride All
          Require all granted
      </Directory>

• If you're displaying EMWIN data:

  • Copy otheremwin.ini from one of the sample configs into your main Vitality GOES config folder
  • Copy the [otheremwin] section from a sample config.ini file into your main config.ini file.
  • Add spaceWeatherAlerts = false (or true) under the [general] section of your config.ini to turn on Space Weather Alerts as Weather Alerts
  • Set fastEmwin to "true" in the [general] section of config.ini to enable fast file parsing for EMWIN text files. Also, set fast to "true" in a category's image section to enable it for a given image
    • Only turn this on if your data is not in subfolders of any kind, like dated subfolders!
    • For more information, see the configuration documentation.
  • None of these changes are required, but necessary to customize the new functionality

• PHP 8.2 or greater is now recommended for performance reasons. This release was validated against PHP 7.4, but future updates will no longer be tested against old PHP versions.

Full Changelog: v1.4.2...v1.5

v1.4.2

What's Changed

• Paginate Other EMWIN Cards
• Fix Cleanup-EmwinText.sh when .txt extension is lower-case
• Add support for SDM Ops Status Messages on Other EMWIN page
• Add NPSA01US and NPIC01US to sample EMWIN configs (compatible with Vitality GOES 1.4.0+)
• Add sample config for FengYun-2x (compatible with Vitality GOES 1.4.0+)
• Improved error handling and bug fixes

Full Changelog: v1.4.1...v1.4.2

v1.4.1

What's Changed

This release contains some quick bug fixes:

• Fix bug where it would hang when switching from a timelapse video back to still images
• Handle more error conditions better (images not found; HTTP error response codes)

If you're updating from a version of Vitality GOES older than 1.4, see the 1.4 changelog because a lot has changed!

v1.4

Sample Configs have been added for the following satellites:

• EWS-G1 (GOES-13) GVAR - Thanks @ZbychuButItWasTaken! Hope you have a beefy computer to view 'em
• GEO-KOMPSAT 2A (GK-2a) LRIT. Fixes #39 - Thanks @KiwiInNZ!

Changes in this release:

• See the "Breaking Change" section below before updating! The imagery categories in the main menu are now customizable! Instead of being stuck with "Full Disk", "Level 2 Imagery", "EMWIN Imagery", and "Mesoscale Imagery", you can now change the name, icon, and contents of all these pages - and add your own categories!
• On GOES-16/18, NWS Images are now viewable
• On GOES-16/18, the "Level 2 Imagery" has been renamed to "Non-CMIP Imagery" by default
• Image filenames can now be parsed if the name or timestamp are in different parts of the filename. See the config docs for supported modes.
• Added some missing emwin imagery into sample emwin.ini configs
• Reduced network overhead for a more responsive experience
• Improved error handling - most errors will now display on the screen instead of making the program lock up at "Loading, Please Wait..."
• Removed GOES-17 from sample configs. If you need GOES-17 configs for Vitality GOES v1.4 or newer, get them from here: https://github.com/JVital2013/vitality-goes/tree/1c7f5c06809a88a19d62be90af2706b37acfb05e/configs
• Other bug fixes

Breaking Changes

There have been major changes to the configuration in this version

• config.ini is now the only hard-coded config file
• To load other ini files (categories) and their associated imagery, config.ini must have a [categories] section with one or more ini files defined under it
• Each of these secondary ini files must also have a [_category_] header at the top to define its name and icon
• Secondary ini files can also be named anything

See the config docs for details on configuration. Scriptconfig.ini has not been affected by this change - although you can remove the GOES-17 references within it.

Migrating an old configuration to 1.4+

Assuming you want to keep loading your original abi.ini, meso.ini, l2.ini, and emwin.ini files, here's how to migrate:

1. In config.ini, add a categories section after the [general] section:

   [categories]
   abi = abi.ini
   meso = meso.ini
   l2 = l2.ini
   emwin = emwin.ini

2. Edit abi.ini and add the following at the very top:

   [_category_]
   title = "Full Disk"
   icon = globe-americas

3. Edit l2.ini and add the following at the very top:

   [_category_]
   title = "Non-CMIP Imagery"
   icon = atom

4. Edit meso.ini and add the following at the very top:

   [_category_]
   title = "Mesoscale Imagery"
   icon = search-plus

5. Edit emwin.ini:
   • Add the following at the very top:

     [_category_]
     title = "EMWIN Graphics"
     icon = image

   • For every EMWIN image defined, rename the path setting to filter and remove the file extension
   • Add the following lines into every image defined in emwin.ini, replacing GOES16 with GOES18 if necessary:

     mode = emwin
     path = {GOES16}/emwin

The only difference between the old and new abi.ini, l2.ini, and meso.ini files is the addition of the [_category_] header, but the emwin.ini conversion is trickier because it now acts like other secondary ini files, whereas before it was a special case.

Here is an comparison between and old and new emin.ini image section:

Note: the sample configs for GOES-16 and GOES-18 now have a new nws.ini file. If you're migrating, you might want to grab one of the nws samples and incorporate it into your setup!

Full Changelog: v1.3...v1.4

v1.3

What's New

• Added support for themes! You can now make Vitality GOES look and feel the way you want through pre-built themes - or make your own! For more information on theming Vitality GOES, see https://github.com/JVital2013/vitality-goes/blob/main/docs/themes.md.
• Add support for changing the website title through the siteTitle config option. I highly recommend doing this if your Vitality GOES instance is exposed to the internet to make it harder (but not impossible) to identify

What's Changed

• Renamed "Configure Location" screen to "Local Settings"
• Force all error levels when debug is set to true, including deprecation notices
• Other bug fixes

Additional Notes

Since this version is being released less than a week after GOES-18 became GOES West, this version still has full sample configs for GOES-17. This is the last version of Vitality GOES that will include samples for GOES-17. GOES-17 will be removed from sample configs and secondary processing scripts for future releases.

If you have existing configs for GOES-17 data you already received, this will keep working after I remove the samples from the repo.

Full Changelog: v1.2...v1.3

v1.2

What's a better way to ring in the new year, than a new Vitality GOES Release! Version 1.2 is full of new features and compatibility options that has something for almost everyone.

Notice: If you used the in-development Home Assistant "integration" from before the Vitality GOES 1.2 release, your forecast may break when updating to the newest HA config. See the troubleshooting section of the HA doc for info on how to fix it.

What's New

• Add support for using SatDump as a data source! This potentially opens up Vitality GOES to other satellites - see the call to action below for more
• Add a Home Assistant configuration that allows you to use Vitality GOES as a "weather provider". See here for more!
• Support the system info screen on Windows Hosts, and give it the ability to pull statistics from SatDump
• Made PowerShell versions of some of the secondary scripts so they can run on Windows. See the scripts documentation for more
• Nearly all documentation has been rewritten to flow better and include SatDump information
• Update menu icon to an actual menu icon
• Update all Himawari references to Himawari-9
• Support more EMWIN weather conditions
• Other bug and security fixes

Call to action

Vitality GOES is based around the GOES-R satellites, but with these recent changes, imagery from other geostationary satellites should work fine. If anyone gets another geo satellite working with it, please share your config with me so I can include a sample in the repository. Thanks!

Full Changelog: v1.1.1...v1.2

v1.1.1

What's Changed

• Add support for parsing text data about Eastern Pacific Hurricanes
• Make cards collapsible in the Hurricane Center
• Other bug fixes

Full Changelog: v1.1...v1.1.1