Skip to content

v1.4

Compare
Choose a tag to compare
@JVital2013 JVital2013 released this 27 Jan 04:16
· 129 commits to main since this release
1aef44c

Sample Configs have been added for the following satellites:

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:

image

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