## 🍏 Build instructions for macOS

### 📁 Prepare folder

> Choose a folder for the future build, for example **/Users/user/TBuild**. It will be named ***BuildPath*** in the rest of this document. All commands will be launched from Terminal.

> **❗️ Note about disk space:** The full build process will require approximately **55 GB** of free space. This includes:
> - **~35 GB** for libraries (when building for both x64 and arm64 architectures)
>- **~20 GB** for the compiled Telegram app (in the `out` folder)

### 🔐 Obtain your API credentials

You will require **api_id** and **api_hash** to access the Telegram API servers.
> To learn how to obtain them **[click here][api_credentials]**.

### ⌨️ Clone source code and prepare libraries

Go to ***BuildPath*** and run

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    brew install git automake cmake wget pkg-config gnu-tar ninja nasm meson

    sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

    git clone --recursive https://github.com/fajox1/fagramdesktop.git tdesktop
    ./tdesktop/Telegram/build/prepare/mac.sh

### 💻 Building the project

Go to ***BuildPath*/tdesktop/Telegram** and run (using [your **api_id** and **api_hash**](#obtain-your-api-credentials))

    ./configure.sh -D TDESKTOP_API_ID=YOUR_API_ID -D TDESKTOP_API_HASH=YOUR_API_HASH

Then launch **Xcode**, open ***BuildPath*/tdesktop/out/Telegram.xcodeproj** and build for Debug / Release.

[api_credentials]: api_credentials.md