Updates

Pick a release channel, check for new versions, and install them in the desktop app.

This works in the desktop app only.

The desktop app checks for new versions of Wrangl and tells you when one is ready. You choose how new the versions are with a release channel.

The browser version has no update settings. It updates together with the server, so reload the page after the server updates. To update the server, see Browser and phone.

Open the update settings

Open app settings with Ctrl+, (Cmd+, on macOS).
Select Updates.

The tab shows the version you have as Wrangl and the number, with the channel and when Wrangl last checked below it.

Pick a release channel

Under Channel, open Release channel and select one of these:

Stable gets production releases. It is the default and the most reliable channel.
Insider gets release candidates, the versions that come before a stable release. They can be unfinished.
Nightly gets builds made automatically from the newest code. They can be unstable.

On Stable and Nightly, Wrangl downloads and installs signed updates in the app. On Nightly the tab says Updates are signed and install in the app.

On Insider, Wrangl does not install updates for you. It tells you about a new version and opens the release page, where you download and install it yourself.

If Wrangl cannot get a signed update on any channel, for example because there is no network or no build for your system yet, it falls back to the release page. The tab then says Automatic update is not available. Download and install it from the release page.

When you switch channels, Wrangl clears an update it found on the old channel. Select Check for updates to look on the new one.

If you installed Wrangl from the AUR on Arch Linux, there is no channel choice. Update with yay -S wrangl.

Check for updates

Select Check for updates. If a new version is out, the tab shows Version and the number, followed by is available.

On macOS you can also use Help > Check for Updates... in the menu bar, or press Cmd+Shift+U.

If a check, download, or install fails, the tab says which step failed. Select Try again to repeat that step.

Turn automatic checks on or off

Check for updates automatically is on by default. Wrangl then checks when it starts and again about every 12 hours. Turn it off to check only when you select Check for updates.

An automatic check does not undo a download. If Wrangl already downloaded a version and the check finds the same one, it stays ready to install.

Install an update

When Wrangl finds a new version, a message appears in the corner of the window: Update available, with the version number below it. On Insider and Nightly, the message starts with the channel name.

Select Download. If the message offers Open download page instead, Wrangl opens the release page and you install the new version yourself.
Wait for the download. A message shows its progress and goes away when the download ends.
When Update ready to install appears, select Install and restart.
Wrangl asks you to confirm. Select Install & Restart, or Not now to install later.

Wrangl closes, installs the update, and opens again. Terminals that are running when you install are closed.

To hide the update message for a day, select Remind me tomorrow.

See what's new

After an update, the first time Wrangl opens it shows a What's New window with the release notes of the new version.

Select View on GitHub to read the release page. Wrangl shows the address in an Open external link? dialog first. Click Open to continue. Links inside the release notes ask the same way.
Select Got it to close the window.

The window shows once for each new version.