Building for macOS

This guide explains how to build the Halloy .app for macOS. If you want to install a signed release version of Halloy on macOS, then you should consult the Installation documentation instead.

Prerequisites

• macOS 11.0 or later
• Latest Rust toolchain
• Xcode Command Line Tools (xcode-select --install or https://developer.apple.com/download/all/)

Steps

1. Clone the Repository

   If you haven’t already, clone the Halloy repository:

   git clone https://github.com/squidowl/halloy.git
   cd halloy
   

2. Run the Build Script

   Execute the build-macos script:

   ./scripts/build-macos.sh
   

   This script will:

   • Build the Halloy binary for both x86_64 and aarch64 architectures.
   • Combine them into a universal binary using lipo.
   • Copy the binary and resources into a macOS .app bundle template located at assets/macos/Halloy.app.
   • Place the .app bundle in target/release/macos.

3. Locate the Built Application

   After the script completes, you’ll find the generated .app bundle at:

   target/release/macos/Halloy.app