====== GTK v2 Client Install for macOS ======

NOTE - this guide is still in the early development and testing phase. Use at your own risk!

**Table of Contents:**
  * [[client:macos#Installation via .dmg|Installation via .dmg.dmg Installation]]
  * [[client:macos#Compiling the Crossfire Client on macOS|Compile from Source Code]]

===== Installation via .dmg =====

Visit [[https://github.com/kettek/crossfire-client-macos-build/releases|Crossfire Client macOS Build]] page for the latest .dmg release of the Client.

^ Release Name            ^ Performance Report ^
| macOS 15 Sequoia        | Waiting Feedback        |
| macOS 14 Sonoma         | Waiting Feedback        |
| macOS 13 Ventura        | Waiting Feedback        |
| macOS 12 Monterey       | Waiting Feedback        |
| macOS 11 Big Sur        | Waiting Feedback        |
| macOS 10.15 Catalina    | Waiting Feedback        |
| macOS 10.14 Mojave      | Waiting Feedback        |
| macOS 10.13 High Sierra | Waiting Feedback        |
| macOS 10.12 Sierra      | Waiting Feedback        |
| OS X 10.11 El Capitan   | Waiting Feedback        |

===== Compiling the Crossfire Client on macOS =====

Follow these steps to compile the Crossfire client on macOS.

=== 1. Install Xcode Command Line Tools ===

Ensure that the Xcode Command Line Tools are installed, as they provide essential compilers and build tools.

  xcode-select --install


=== 2. Install Homebrew ===

[[https://brew.sh/|Homebrew]] is a package manager for macOS that simplifies the installation of software.


  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"


=== 3. Install Required Dependencies ===

The Crossfire client depends on several libraries. Use Homebrew to install them:

  brew install gtk+3
  brew install libpng
  brew install gettext
  brew install cmake


=== 4. Obtain the Crossfire Client Source Code ===

Download the source code from the official repository:


  git clone https://git.code.sf.net/p/crossfire/crossfire-client

Change (cd) to the client source code directory:

  cd crossfire-client


=== 5. Configure the Build Environment ===

Set up the build environment using CMake:


  mkdir build
  cd build
  cmake ..


=== 6. Compile the Client ===

Build the client using the `make` command:


  make


=== 7. Install the Client ===

After a successful build, install the client:


  sudo make install


=== 8. Run the Client ===

Launch the Crossfire client:


  crossfire-client-gtk2


=== Additional Notes ===

  * **XQuartz Installation:** If you encounter issues related to X11 during the build or runtime, consider installing XQuartz, which provides the X11 environment for macOS.

  brew install xquartz