Installing GW on macOS

To install GW as a desktop application (Intel or Apple silicone), click one of the download links below, or head over to GitHub Releases page.

To install GW on macOS as a command-line tool, you have two primary options depending on your system architecture: using Conda or Homebrew. These instructions cover both Intel-based (x86_64) and Apple Silicon (M1, M1 Pro, M1 Max, M2, etc.) Macs.

Using Conda (Intel chips)

For users who prefer using Conda , GW can be installed from the Conda-Forge and Bioconda channels. This method works for Intel architectures only. Open your terminal and execute the following command:

conda install -c conda-forge -c bioconda gw

Using Homebrew (Intel + Apple chips)

For those who prefer Homebrew, GW has a Homebrew tap available. This method is compatible with both Intel and Apple Silicon Macs. Open your terminal and run:

brew install kcleal/homebrew-gw/gw

Building from source

Before building GW, you need to install the glfw3 and htslib libraries. These can be easily installed using Conda.

conda install -c conda-forge -c bioconda glfw htslib

Next clone the GW repository:

git clone https://github.com/kcleal/gw.git && cd gw

Set the CONDA_PREFIX environment variable so gw can use the required libraries.

export CONDA_PREFIX=~/miniconda3

Build gw using

make prep && make

Also, it is recommended to add GW to your bin directory:

cp gw /usr/local/bin


After installation, you can verify that GW has been installed correctly by running:

gw --version