Skip to content
Star43
Download

Install

Download the latest build for your platform below, or pick any version on the Releases page. Once installed, TableCraft updates itself.

Platform Download
macOS (Apple silicon) TableCraft-arm64.dmg
macOS (Intel) TableCraft-x64.dmg
Windows x64 TableCraft-x64.exe
Linux x64 TableCraft-x86_64.AppImage

The builds are not signed with a paid certificate, so the first launch needs one extra step:

  • macOS: see Running the unsigned macOS app below.
  • Windows: SmartScreen says Windows protected your PC; click More info, then Run anyway.
  • Linux: make the AppImage executable with chmod +x TableCraft-*.AppImage and run it.

To make sure a download arrived intact, check it against SHA256SUMS.

Every release also carries SHA256SUMS, the SHA-256 of each file on the release (decision 135).

  1. Download SHA256SUMS into the folder that holds the installer.

  2. From that folder, run:

    Terminal window
    # macOS
    shasum -a 256 -c --ignore-missing SHA256SUMS
    # Linux
    sha256sum -c --ignore-missing SHA256SUMS

Each file you downloaded prints OK. Anything else means the download is damaged, so delete it and download it again.

Compare the output of this PowerShell command with the installer’s line in SHA256SUMS:

Terminal window
(Get-FileHash .\TableCraft-<version>-x64.exe -Algorithm SHA256).Hash.ToLower()

The checksums prove a download is intact, not who made it. Updates the app installs itself are checked against a signed manifest instead (Updates).

The DMGs are ad-hoc signed rather than notarized, because a Developer ID belongs to whoever ships the build and not to this repository (decision 033).

macOS quarantines anything a browser downloaded, and Gatekeeper refuses to open a quarantined app it cannot verify. Depending on the macOS version it says either “TableCraft” Not Opened. Apple could not verify “TableCraft” is free of malware… or “TableCraft” is damaged and can’t be opened. The app is not damaged; only the download attribute is in the way.

Pick the DMG that matches your Mac: arm64 for Apple silicon, x64 for Intel. An app you build yourself with bun run desktop:package was never downloaded, so it carries no quarantine and opens directly.

  1. Open the DMG and drag TableCraft.app to /Applications.

  2. Clear the attribute the download added:

    Terminal window
    xattr -dr com.apple.quarantine /Applications/TableCraft.app
  3. Open TableCraft as usual.

Nothing inside the app changes. Only that attribute is removed, and only once per download.

If you would rather not use the terminal and macOS showed Not Opened:

  1. Click Done.
  2. Open System Settings → Privacy & Security and scroll to Security.
  3. Click Open Anyway next to the message about TableCraft.
  4. Confirm with your password.

That button appears only for an hour or so after the refused launch. The damaged message offers no such button; use xattr.

A little after launch, and every 2 hours while it runs, TableCraft asks GitHub whether a newer release is out. When there is one, an Update button appears in the main toolbar, just left of Settings. Nothing is downloaded until you click it and choose Download.

  1. Click Update in the main toolbar.
  2. Choose Download. The button shows the progress.
  3. Click Restart to Update.

TableCraft quits, puts the new version in place of the old one and opens again. On Windows the update runs the installer silently and reopens TableCraft; on Linux it replaces the AppImage you started.

Skip This Version hides that release until a newer one comes out. Later closes the popover and leaves the button where it is.

  • Help → Check for Updates… asks right away, and says so when you are up to date.
  • Turn off Check for updates automatically in Settings → Advanced to check only from Help.
  • Turn on Get beta versions in Settings → Advanced to be offered betas (1.16.0-beta.1) ahead of each release, and pre-release plugins with them. A beta you install by hand has it on already. Turning it off never downgrades: you keep the beta until a newer release is out.

Every release is described by a manifest signed with the project’s key. TableCraft refuses a manifest whose signature does not verify and a download whose SHA-256 does not match it, deletes what it fetched and tells you why (decision 044).

On macOS the app replaces itself only from a folder you can write to, such as /Applications. Run from the disk image or from a folder macOS moved it to, the button explains what to do and links to the release instead.

The same goes when macOS’s App Management protection would stop the app from replacing itself. Allow TableCraft in System Settings → Privacy & Security → App Management, or install the release by hand. If a Restart to Update still leaves the old version in place, the button says why on the next launch instead of offering the update as if new.

Answer the keychain prompt after an update

Section titled “Answer the keychain prompt after an update”

macOS asks for your keychain password after every update. The app is ad-hoc signed, so each version looks like a different app to the keychain. Before the new version opens, macOS asks for your login keychain password to let it read “TableCraft Safe Storage”. Enter it and choose Always Allow.

Deny leaves passwords saved Forever unreadable, so connecting asks for them, until you allow it at a later launch. Installing a new DMG by hand asks the same.

Release v0.1.0 predates updates. Install the next release by hand once, and it keeps itself current from then on.

You need Bun and Node; CONTRIBUTING.md names the versions and the rest of the toolchain.

Terminal window
bun install
bun run desktop # build and launch the app
bun run desktop:package # an installer for this machine in packages/desktop/release/