Installation Guide

Welcome to the installation guide for Matcha.

 MacOS

The recommended way to install Matcha on macOS is via Homebrew.

brew tap floatpane/matcha
brew install floatpane/matcha/matcha

After installation, run:

matcha

[!WARNING] If you have the "other" Matcha already installed, you will have to rename the executable to avoid conflicts.

You can download pre-compiled binaries from the Releases page.

Download the appropriate archive for your architecture (e.g., matcha_0.17.0_darwin_amd64.tar.gz or matcha_0.17.0_darwin_arm64.tar.gz).
Extract the archive.
Move the binary to your path:
```
mv matcha /usr/local/bin/
```
Run it:
```
matcha
```

You can also install Matcha on Linux via Homebrew.

brew tap floatpane/matcha
brew install floatpane/matcha/matcha

Matcha is available on the Snap Store.

sudo snap install matcha

You can install Matcha via Flatpak using the following command:

flatpak install https://matcha.floatpane.com/matcha.flatpakref

You can download pre-compiled binaries from the Releases page.

Download the appropriate archive for your architecture (e.g., matcha_0.17.0_linux_amd64.tar.gz or matcha_0.17.0_linux_arm64.tar.gz).
Extract the archive.
Move the binary to your path:
```
mv matcha /usr/local/bin/
```
Run it:
```
matcha
```

Currently, there is no native support for Windows. Please see issue #123 for more details.

You can run Matcha on Windows using WSL (Windows Subsystem for Linux).

Once you have WSL installed and set up, you can follow the Linux installation instructions inside your WSL terminal.

If you have Go installed, you can build Matcha from source:

go build .