Encrust
All guides

Getting started · Guide 1 of 21

Install Encrust

4 min read

On Windows, install Encrust from the Microsoft Store: no warning, and the Store keeps it updated. On macOS and Linux, download the file for your system from the latest release. The downloads aren't code-signed, so macOS needs one Terminal command before the first launch. The Linux packages need no extra step.

Before you start

Encrust runs on macOS 12 or later (Apple silicon or Intel), on Windows 10 or 11, and on Linux, the last two on x86-64 or ARM64. It needs a graphics card with Vulkan, Metal or DirectX 12.

Every file is on the latest release page on GitHub, and the download page links the same files by system.

System File
macOS, Apple silicon Encrust-macos-aarch64.dmg
macOS, Intel Encrust-macos-x86_64.dmg
Windows Microsoft Store, or Encrust-windows-x86_64-setup.exe (ARM64: Encrust-windows-aarch64-setup.exe)
Linux, x86-64 Encrust-linux-x86_64.AppImage or encrust_amd64.deb
Linux, ARM64 Encrust-linux-aarch64.AppImage or encrust_arm64.deb

The encrust-*.tar.gz and .zip archives beside them are portable copies, and what the in-app update downloads. You don’t need them to install.

Install on macOS

The builds aren’t code-signed. Signing takes a paid Apple developer account, and these builds don’t have one, so Gatekeeper quarantines the download and you clear that once.

  1. Open the .dmg for your Mac and drag Encrust into Applications.

  2. Open Terminal and run:

    xattr -dr com.apple.quarantine /Applications/Encrust.app

    Run it only on a copy you downloaded from the release page linked above.

  3. Open Encrust from Applications.

The command assumes Encrust is in the main Applications folder. If you put it elsewhere, change the path.

Install on Windows

On Windows, Encrust comes from the Microsoft Store, one listing for x86-64 and ARM64 PCs. The Store signs the package itself, so Windows installs it without a warning, and the Store updates it from then on.

  1. Open Encrust in the Microsoft Store and install it.
  2. Start Encrust from the Start menu.

A new release reaches the Store hours to days after it appears on GitHub, once Microsoft has certified it.

With the installer instead

The installer from the release page is for a PC without the Store, or for a release that hasn’t reached the Store yet. Windows SmartScreen warns about it for the same reason as macOS: there’s no certificate behind it, and no reputation either until enough people have downloaded it.

  1. Download Encrust-windows-x86_64-setup.exe, or Encrust-windows-aarch64-setup.exe on an ARM64 PC, and run it.
  2. If SmartScreen blocks it, click More info, then Run anyway.
  3. Finish the installer and start Encrust.

The installer installs for your user only, so the app can later replace its own files without elevation. A copy from the installer and one from the Store are two separate installs, each with its own settings: keep one and uninstall the other.

Install on Linux

Linux gets two packages, and neither needs a warning step.

  • AppImage: Encrust-linux-x86_64.AppImage, or Encrust-linux-aarch64.AppImage on ARM64, one file you run directly.
  • Debian or Ubuntu package: encrust_amd64.deb, or encrust_arm64.deb on ARM64, installed by your package manager. It depends on libgtk-3-0 (or libgtk-3-0t64) and libxkbcommon0.

We build on Ubuntu 22.04, and a Linux binary can’t run against a glibc older than the one it was built with. If your distribution is older, build from source: the steps are under “Build from source” on the download page.

Keep it up to date

Encrust looks for a new release once a day, on by default. When it finds one, a pill appears in the top bar and a notice reads “Encrust X is out”. Click either to open the Update sheet, which shows the release notes, the download size and the date.

To turn the daily look off, open File > Settings…, go to Updates, and switch off Look for a new release once a day. The same page has a Check now button for an immediate look and, when a release is newer than yours, a Download and install button. Encrust downloads the archive and checks its signature before it replaces anything. Then click Restart now.

That button works for the macOS app, the copy from the Windows installer and the portable archives. An AppImage runs from a read-only mount and a .deb belongs to your package manager, so for those the page points you to the release page and you download the new file.

A copy from the Microsoft Store updates through the Store. Its Updates page has the same Check now button, asks the Microsoft Store for a newer package and offers Update in the Microsoft Store, which opens Encrust’s page there. It never looks for updates on GitHub.

If something goes wrong

macOS refuses to open Encrust. Run the xattr command above, then open the app again. If Terminal says there’s no such file, Encrust isn’t in /Applications.

Windows doesn’t offer Run anyway. The button appears only after you click More info on the SmartScreen window. Or skip the warning altogether and install from the Microsoft Store.

The window doesn’t open. Check that your graphics card and driver support Vulkan, Metal or DirectX 12. If they do, open an issue with your system and graphics card.

Sources