Skip to content

Tell users when a new release is out - #15

Merged
jay739 merged 1 commit into
mainfrom
feat/update-check
Nov 9, 2026
Merged

jay739 merged 1 commit into
mainfrom
feat/update-check

Conversation

@jay739

@jay739 jay739 commented Nov 9, 2026

Copy link
Copy Markdown
Owner

What

Both apps now tell you when a new release is out.

  • Ten seconds after launch and then once a day, the app asks GitHub for the latest release (/releases/latest).
  • A newer release appears at the top of the tray or menu bar menu ("Update available: v…") and is announced once: a balloon on Windows, an alert on macOS. Either opens the release page.
  • "Check for updates" in the menu checks right away and reports the result, including a specific message when GitHub cannot be reached or rate-limits the check.
  • The daily check can be turned off in Settings on both platforms. Development builds (0.0.0) skip it, so macOS's Info.plist now defaults to 0.0.0 instead of 1.0.0, which looked newer than every release.
  • Nothing is downloaded or installed automatically, and only pages inside this repository are ever opened, whatever the reply says.

Why

Users had no way to learn about a new version short of visiting the repository. Notify-only keeps it safe: the builds are ad-hoc signed and not notarized, so installing an update automatically would mean running an unverified download.

How it was tested

  • windows/test.bat (new, run in this PR's Windows job) and macos/test.sh both cover the same 15 checks: numeric comparison, prereleases, build metadata, unreadable tags, foreign release pages and malformed replies. Locally: 15/15 on Windows, and test.sh 40/40 on the Mac Mini.
  • Called the real GitHub API from the compiled Windows code (.NET Framework, TLS 1.2, User-Agent) and from the Swift code: both found v0.2.2, its release page, and compared versions correctly.
  • Builds on both platforms add no new compiler warnings.
  • The menu item, balloon and alert have not been clicked through yet; tracked as B-3 in BACKLOG.md.

Ten seconds after launch and then once a day, both apps ask GitHub for the
latest release. A newer one appears at the top of the tray or menu bar menu
and is announced once, with a balloon on Windows and an alert on macOS; either
opens the release page. Nothing is downloaded or installed automatically.
"Check for updates" in the menu checks right away, and the daily check can be
turned off in Settings. Development builds (0.0.0) skip the automatic check,
so the macOS Info.plist now defaults to 0.0.0 instead of 1.0.0, which looked
newer than every release.

Each platform reports failures as a closed set of error types whose messages
say what went wrong and what to do. Version comparison and reply parsing are
covered by the same 15 checks on both: windows/test.bat (new, run in CI) and
macos/test.sh.

Also replaces the em dashes in the files this touches.
@jay739
jay739 merged commit 9175ce7 into main Nov 9, 2026
3 checks passed
@jay739
jay739 deleted the feat/update-check branch November 9, 2026 22:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant