Files
tdesktop/docs/building-mac.md
allhaileris afb81b8278
Some checks failed
Docker. / Ubuntu (push) Has been cancelled
User-agent updater. / User-agent (push) Failing after 15s
Lock Threads / lock (push) Failing after 10s
Waiting for answer. / waiting-for-answer (push) Failing after 22s
Close stale issues and PRs / stale (push) Successful in 13s
Needs user action. / needs-user-action (push) Failing after 8s
Can't reproduce. / cant-reproduce (push) Failing after 8s
init
2026-02-16 15:50:16 +03:00

1.5 KiB

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.

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/telegramdesktop/tdesktop.git
./tdesktop/Telegram/build/prepare/mac.sh

Building the project

Go to BuildPath/tdesktop/Telegram and run (using your api_id and api_hash)

./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.