Skip to main content

Updates & Notifications

Checking for updates​

Kshan can check for and install new versions in-app on macOS, Windows, and Linux. There are two kinds of update notices:

  • A required update — blocks the app until you update, if your version is too old.
  • An optional update — a dismissible notice you can act on whenever.

You'll see an update notice as:

  • A dismissible banner over the dashboard with an Update Now button
  • A badge dot on the sidebar's Updates entry
  • On macOS, Check for Updates… / Update Now items in the app menu bar
  • Settings → Updates → Check for Updates, which shows a toast either way ("up to date" or an update notice with an Update Now action)

:::info Media needed — Screenshot Capture: The dismissible update banner over the dashboard, with its "Update Now" button. Suggested file: static/img/screenshots/update-banner.png :::

:::info Media needed — Screenshot Capture: The macOS Gatekeeper "Kshan is damaged and can't be opened" (or similar) dialog, referenced in the troubleshooting tip just below. Suggested file: static/img/screenshots/gatekeeper-damaged-dialog.png :::

:::tip Troubleshooting: "app is damaged" or won't open after updating on macOS Kshan's macOS builds aren't currently signed with an Apple Developer certificate, so Gatekeeper may block a freshly updated copy. If that happens, right-click the app and choose Open instead of double-clicking, or run xattr -cr /Applications/Kshan.app in Terminal to clear the quarantine flag. :::

In-app notifications (toasts)​

Brief pop-up messages appear at the bottom of the app to confirm actions or report errors — for example after signing in, connecting an integration, or clearing local data. Info/success toasts stay for 4 seconds, error toasts for 6. Only one shows at a time; a new toast replaces whatever's currently showing rather than queuing behind it.