Skip to content

Auto Update

KaiUR edited this page May 14, 2026 · 2 revisions

Auto Update

CatiaMenuWin32 checks for updates automatically on startup and can install them without leaving the app.

How It Works

  1. On startup the app calls the GitHub Releases API to get the latest release tag
  2. If the latest version is newer than the current version (comparing major.minor.patch only), an update notification appears in the toolbar
  3. Clicking the notification opens the update dialog

Update Dialog

If Auto-install updates is enabled in Settings:

  • A dialog asks "Download and install automatically?"
  • Clicking Yes downloads the new .exe directly from GitHub Releases
  • The app shows "Closing to install..." then exits
  • A batch script replaces the old .exe with the new one and restarts the app
  • Clicking No opens the GitHub Releases page in your browser instead

If Auto-install updates is disabled, the dialog always opens the releases page.

Check for Updates (manual)

Go to ☰ Menu → Help → Check for Updates… to trigger an immediate update check in the background without waiting for the next startup.

  • If no newer version is found, the status bar shows "App is up to date (vX.Y.Z)"
  • If a newer version is found:
    • With Auto-install updates enabled: the automatic download-and-replace flow starts (same as the startup auto-update)
    • With Auto-install updates disabled: the standard prompt appears offering to open the releases page

Manual Update

Go to the releases page, download the latest CatiaMenuWin32.exe, and replace your existing one.

Version Numbers

Versions follow major.minor.patch.build. The update check only compares major.minor.patch — local dev builds with a higher build number than the latest release will not trigger the update prompt.

Troubleshooting

Update prompt appears on local builds — run git fetch --tags and git pull origin main then delete the build folder and rebuild. The CMake version detection needs the latest release tags locally.

Download failed — check your internet connection. If you are behind a corporate firewall that blocks github.com, use manual update instead.

Clone this wiki locally