closes: https://github.com/wez/wezterm/pull/5815 closes: #5466 closes: #5805 closes: #5433
2.6 KiB
Installing on macOS
The CI system builds the package on macOS Big Sur and should run on systems as "old" as Mojave. It may run on earlier versions of macOS, but that has not been tested.
Starting with version 20210203-095643-70a364eb, WezTerm is a Universal binary with support for both Apple Silicon and Intel hardware.
[:simple-apple: Download for macOS :material-tray-arrow-down:]({{ macos_zip_stable }}){ .md-button } [:simple-apple: Nightly for macOS :material-tray-arrow-down:]({{ macos_zip_nightly }}){ .md-button }
- Download Release.
- Extract the zipfile and drag the
WezTerm.app
bundle to yourApplications
folder. - First time around, you may need to right click and select
Open
to allow launching the application that you've just downloaded from the internet. - Subsequently, a simple double-click will launch the UI.
- To use wezterm binary from a terminal emulator, like
wezterm ls-fonts
you'll need to add the location to the wezterm binary folder that exists inside the WezTerm.app, to your environment's $PATH value. For example, to add it to your~/.zshrc
file, and assuming your WezTerm.app was installed to/Applications
, add:
PATH="$PATH:/Applications/WezTerm.app/Contents/MacOS"
export PATH
- Configuration instructions can be found here
Homebrew
WezTerm is available for brew users:
$ brew install --cask wezterm
If you'd like to use a nightly build:
$ brew install --cask wezterm@nightly
!!! note
For users who have previously used the cask named wezterm-nightly
,
homebrew has started issuing warnings: Warning: Cask homebrew/cask-versions/wezterm-nightly was renamed to wezterm@nightly
. We
recommend that you use brew uninstall wezterm-nightly
to uninstall the
previously installed version, and then reinstall the new version using the
command above.
to upgrade to a newer nightly (normal brew upgrade
will not upgrade it!):
$ brew upgrade --cask wezterm@nightly --no-quarantine --greedy-latest
!!! note
The --greedy-latest
option in Homebrew forces the latest version of a
formula to be installed, even if a version satisfying the formula's
requirements is already installed. This can be useful when you want to
ensure you have the most up-to-date version of a package, regardless of
whether an older version meets the current dependency requirements.
MacPorts
WezTerm is also available via MacPorts:
$ sudo port selfupdate
$ sudo port install wezterm