StageDesigner

Updates

How to install a new version with the Update button, what to do when the update does not install, and how to check the installer’s SHA-256 checksum.

2 min read
Documentation contents ▾

Since version 0.3.8 the app tells you about a new release by itself and installs it with the Update button. Older versions need to be updated manually once from the Download page.

Updating from the app

  1. After launch, when a new version is available, the New version available window appears with a list of changes. You can also check manually: Help → Check for updates… (on macOS also in the StageDesigner menu).
  2. Click Update. The file downloads in the background, and you can keep working meanwhile.
  3. After the download the app checks the file size and SHA-256 checksum, and on macOS also the Apple signature.
  4. Confirm the installation. The app saves project changes to the cloud, quits, installs the new version and restarts.

When your version is current, Check for updates… shows the message "You have the latest version of StageDesigner". The menu item changes its name to Update to version X… when a new release is waiting to be installed.

When the update does not install on its own

MessageWhat to do
"The app is running from the DMG image or the Downloads folder"Move StageDesigner to the Applications folder and launch it from there. Later updates will install on their own.
"No write permission in the app folder"The app opens the installer. On macOS drag the new version to the Applications folder, replacing the previous one.
"The checksum of the downloaded file does not match" / "The saved file is damaged"The file downloaded with an error. Try again or download the installer from the website.
"This version is available for Macs with Apple Silicon"On a Mac with an Intel processor, write to us and we will prepare a build on request.

Manual download from the website

  1. Open Download. The page picks the installer for your system and processor.
  2. macOS: open the DMG file and drag StageDesigner to the Applications folder, replacing the old version.
  3. Windows: run the .exe installer. Projects and the license stay.

Checking the SHA-256 checksum

Under each download button there is a short form of the checksum, e.g. SHA-256 0739dd7ddd1e…. The full checksum appears when you hover over it. Compare it with the checksum of the downloaded file:

macOS (Terminal)
shasum -a 256 ~/Downloads/StageDesigner-<version>-arm64.dmg
Windows (PowerShell)
Get-FileHash $HOME\Downloads\StageDesigner-<version>-x64-setup.exe -Algorithm SHA256

The checksums must be identical character by character (letter case does not matter). If they differ, delete the file and download it again.

After the update

  • The change list for each version is on the Download page and in the version history.
  • On macOS you may need to grant screen recording permission again after an update, see Empty window and display lists.
  • If a ticket in the panel has the status "deployed", the fix is in the latest version of the app.
Did not find the answer?
Describe the problem and we will reply with a solution or add an article.