================================================================================
              Astrophotography Weather Widget  --  v2.0.0
       A night-vision desktop weather HUD for astrophotography field use
                 (C) 2026 Martin P. Heigan  --  anti-matter-3d.com
================================================================================

A compact, night-vision-friendly desktop widget showing the observing-relevant
weather at a glance, without opening a browser. It lives in the system tray
rather than the taskbar, so it stays out of your running-apps list during a
session.


--------------------------------------------------------------------------------
 ALSO AVAILABLE IN THE SUITE
--------------------------------------------------------------------------------

  This tool is also included in the mh_astro_tools Suite, alongside the
  Exposure Calculator, UTC / GPS / Weather, 500 Rule Calculator, Night Vision
  Overlay and Scientific Calculator, all opened from a common Launcher.

  The application is IDENTICAL in both -- only the distribution differs:

    Standalone ZIP ..... the Weather Widget alone; extract and run
    Suite installer .... all seven tools, a Launcher, shortcuts and manuals

  Do not run both copies at once. They are the same application and will
  compete for the same settings.

  Suite and updates ... https://anti-matter-3d.com/tools/


--------------------------------------------------------------------------------
 CONTENTS OF THIS RELEASE
--------------------------------------------------------------------------------

  mh_astro_weather_widget_v2_0_0\
      mh_astro_weather_widget_Win_x64_v2_0_0.exe ... run this
      README.txt ................................... this file
      License.txt .................................. licence summary
      License_Agreement.pdf ........................ full licence agreement
      Astrophotography_Weather_Widget_User_Manual.pdf
      SHA256SUMS.txt ............................... per-file checksums
      manifest.json ................................ release metadata
      release_manifest.cat ......................... signed catalogue
      release_info.txt ............................. build and signing details

  The folder also contains the Qt libraries, timezone data and icons the
  application needs. These are hidden to keep the view tidy; turn on "Hidden
  items" in Explorer's View tab to see them. Nothing depends on whether they
  are visible, but they must not be moved or deleted.


--------------------------------------------------------------------------------
 QUICK START
--------------------------------------------------------------------------------

  1. Right-click the ZIP -> "Extract All..." and choose any folder you can
     write to.
  2. KEEP THE EXTRACTED FOLDER STRUCTURE INTACT. The application loads its
     icons, Qt libraries and timezone data from subfolders beside the
     executable; moving or deleting them will stop it starting.
  3. Double-click mh_astro_weather_widget_Win_x64_v2_0_0.exe

  Upgrading from v1.x: delete the old extracted folder first. The two versions
  use different folder and executable names, so they will not overwrite each
  other.

  To uninstall, delete the extracted folder. Nothing is added to the registry
  except the optional run-at-startup entry, which is removed by clearing that
  setting before you delete the folder.


--------------------------------------------------------------------------------
 WHAT IT SHOWS
--------------------------------------------------------------------------------

  Temperature and dew point, with the temperature-to-dew-point spread
  Condensation-risk label from that spread -- EXTREME / HIGH / MED / LOW
  Wind speed
  Barometric pressure with a trend arrow
  Sky condition (WMO weather text)

  Units toggle .... Metric (default) or Imperial (deg F / inHg / mph)


--------------------------------------------------------------------------------
 SYSTEM REQUIREMENTS
--------------------------------------------------------------------------------

  Operating system ... Windows 10 or 11, 64-bit
  Internet ........... required for weather data; astronomical values are
                       computed offline
  Runtime ............ none required; Python and all libraries are bundled


--------------------------------------------------------------------------------
 USER DATA
--------------------------------------------------------------------------------

  Settings are stored per-user under:
    Documents\mh_astro_tools\mh_astro_weather_widget\

  Deleting the extracted folder does not delete this folder.


--------------------------------------------------------------------------------
 LICENSE
--------------------------------------------------------------------------------

  Licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives
  4.0 International licence (CC BY-NC-ND 4.0). You may use, share and
  redistribute this tool in its original form, with attribution, for
  non-commercial purposes; you may not sell it or distribute modified versions.

  Summary ...... License.txt  (in this folder)
  Full terms ... License_Agreement.pdf
  Legal code ... https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode

  For permissions beyond the licence, use the contact form below.


--------------------------------------------------------------------------------
 SECURITY
--------------------------------------------------------------------------------

  The executable is code-signed by Certum with SHA-256 Authenticode and an
  RFC-3161 timestamp, and is submitted to Microsoft (WDSI) and VirusTotal
  before release. SHA256SUMS.txt and the signed release_manifest.cat let you
  verify every file after extraction; the archive's own SHA-256 is published
  with the release.

  Note on false positives: freshly published, low-reputation executables can
  trigger heuristic, reputation-based warnings in some browsers and antivirus
  engines. These are not detections of actual malware. If you see such a
  warning, verify the Authenticode signature (right-click -> Properties ->
  Digital Signatures) and the published SHA-256 before running.


--------------------------------------------------------------------------------
 SUPPORT & MORE TOOLS
--------------------------------------------------------------------------------

  Releases ............ https://github.com/MHeigan/mh_Astro_Weather_Widget/releases
  Tools and updates ... https://anti-matter-3d.com/tools/

================================================================================
