Install JusTTY

Homebrew#

JusTTY ships from a personal tap, not the official homebrew-cask, because release builds are self-signed rather than notarized. Homebrew 6 and later asks you to trust a third-party tap before installing from it.

brew trust --tap 0x96f/justty
brew tap 0x96f/justty
brew install --cask justty

The cask runs a postflight step that clears quarantine, so you should not need the manual xattr workaround described in Troubleshooting.

More on the tap, including how maintainers bump the cask, is in Homebrew Tap.

Manual download#

1
Download the release

Grab Justty-macos.zip from the latest release.

2
Unzip it

You get Justty.app.

3
Move it somewhere lasting

/Applications or ~/Applications both work. Running the app from your Downloads folder works too, but you will lose it.

4
Open it

macOS blocks the first launch because the build is self-signed. First Launch walks through getting past that.

Verify what you installed#

Release builds carry a stable identity called Justty Self-Signed. Check it before you trust the binary:

codesign -dv --verbose=4 Justty.app
# expect Authority=Justty Self-Signed
codesign --verify --verbose=4 Justty.app

The identity is the same on every CI release, so a mismatch means the app did not come from the project. Details on how it is created and stored are in Code Signing.

Next#

  • First Launch — get through Gatekeeper and open your first shell
  • Requirements — check your macOS version first if the app refuses to open

Updated

Powered by Docsbook