1
1
mirror of https://github.com/wez/wezterm.git synced 2024-10-27 08:09:45 +03:00
wezterm/docs/install/macos.markdown
loishi 0bda17d684 Change to the command to upgrade wezterm-nightly
Hi,

I encountered an error while trying to upgrade Wezterm to a newer nightly build on MacOS using the previous brew command. The error message was:

“Error: Cask wezterm-nightly exists in multiple taps:
homebrew/cask-versions/wezterm-nightly
wez/wezterm/wezterm-nightly”

To resolve this issue temporarily, I modified the shell script to use the "wez/wezterm/wezterm-nightly" tap. However, I wanted to check if it's preferable to use the "homebrew/cask-versions/wezterm-nightly" tap instead. Please let me know your thoughts on this.

Thanks!
2023-02-06 05:04:12 -08:00

54 lines
1.8 KiB
Markdown

## 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.
<a href="{{ macos_zip_stable }}" class="btn">Download for macOS</a>
<a href="{{ macos_zip_nightly }}" class="btn">Nightly for macOS</a>
1. Download <a href="{{ macos_zip_stable }}">Release</a>
2. Extract the zipfile and drag the `WezTerm.app` bundle to your `Applications` folder
3. First time around, you may need to right click and select `Open` to allow launching
the application that your just downloaded from the internet.
3. Subsequently, a simple double-click will launch the UI
4. 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:
```sh
PATH="$PATH:/Applications/WezTerm.app/Contents/MacOS"
export PATH
```
5. Configuration instructions can be [found here](../config/files.html)
## Homebrew
WezTerm is available for [brew](https://brew.sh/) users in a tap:
```bash
$ brew tap wez/wezterm
$ brew install --cask wez/wezterm/wezterm
```
If you'd like to use a nightly build:
```bash
$ brew install --cask wez/wezterm/wezterm-nightly
```
to upgrade to a newer nightly (normal `brew upgrade` will not upgrade it!):
```bash
$ brew upgrade --cask wez/wezterm/wezterm-nightly --no-quarantine --greedy-latest
```
## MacPorts
WezTerm is also available via [MacPorts](https://ports.macports.org/port/wezterm/summary):
```bash
$ sudo port selfupdate
$ sudo port install wezterm
```