Updates and Troubleshooting

What the Updates Page Shows

In Settings > Updates, LaunchNext now surfaces the full update flow in one place.

Top Hero

The large banner at the top reflects the current state:

• your current version when nothing special is happening
• Version up to date after a successful check
• Update available when a newer release is found

Controls

The main controls on this page are:

• Check for Updates or Check again: starts a manual check
• Download update: appears when a release is available
• Auto check for updates: decides whether LaunchNext checks in the background
• Open updater config: opens the updater configuration file for inspection or manual cleanup

Status Card

The status card can show:

• idle state
• checking progress
• up-to-date confirmation
• update available with version number
• failed state with the returned error message

Release Notes

When an update includes notes, LaunchNext now renders them directly inside the settings page as Markdown.

That means you can read headings, lists, code blocks, and normal paragraphs without leaving the app before deciding whether to download.

Suggested Update Workflow

1. Open Settings > Updates.
2. Click Check for Updates.
3. Read the status card and the Release Notes block if a release is found.
4. Click Download update.
5. If the updater behaves unexpectedly, use Open updater config to inspect the updater state.

Common Issues

App blocked by macOS

sudo xattr -r -d com.apple.quarantine /Applications/LaunchNext.app

Update check failed

• Check your network first.
• Click Check again once more to refresh the state.
• Open the updater config file if you need to inspect stale updater data.

Release notes are empty

Some releases may not ship notes. This is not necessarily an error. If the version is shown and download is available, the updater can still be working normally.

Import failed

• Confirm selected folder contains Data.store
• Confirm backup folder format is valid (LaunchNext_... .launchnext)
• Retry import and choose only needed sections first

Missing apps after source changes

• Re-open Settings > App Sources
• Verify custom paths still exist
• Refresh app data

Shortcut or gesture stopped working

• Re-record the shortcut in Settings > Shortcut & Gesture
• For four-finger gestures, turn off Show Desktop in macOS first
• If the issue started after sleep or wake, relaunch LaunchNext once to fully reset input monitoring