Tribler development environment setup on MacOS (10.10 to 10.13).

  1. MacPorts
  2. HomeBrew
  3. Tribler
  4. Notes


MacPorts Install instructions at To install the Tribler dependencies using MacPorts, please run the following command in your terminal:

sudo port -N install git ffmpeg qt5-qtcreator libtorrent-rasterbar gmp mpfr libmpc libsodium py37-Pillow py37-twisted \
py37-cherrypy3 py37-cffi py37-chardet py37-configobj py37-gmpy2 py37-pycparser py37-numpy py37-idna py37-cryptography \
py37-decorator py37-netifaces py37-service_identity py37-asn1-modules py37-pyinstaller py37-pyqt5 py37-sqlite py37-matplotlib py37-libnacl



Skip to Tribler if you are using MacPorts because HomeBrew is a less complete alternative to MacPorts.

HomeBrew installation instructions can be found at


If you wish to run the Tribler Graphical User Interface, PyQt5 should be available on the system. While PyQt5 is available in the pip repository, this is only compatible with Python 3. To install PyQt5, we first need to install Qt5, a C++ library which can be installed with brew:

brew install qt5, sip, pyqt5
brew cask install qt-creator # if you want the visual designer
qmake --version # test whether qt is installed correctly


An essential dependency of Tribler is libtorrent. libtorrent is dependent on Boost, a set of C++ libraries. Boost can be installed with the following command:

brew install boost
brew install boost-python

After that you can install it with

brew install libtorrent-rasterbar

For the final check you can test whether libtorrent is correctly installed by executing:

>>> import libtorrent

Other Packages

There are a bunch of other packages that can easily be installed using pip and brew:

brew install homebrew/python/pillow gmp mpfr libmpc libsodium
sudo easy_install pip
pip install --user cython  # Needs to be installed first for meliae
pip install --user bitcoinlib cherrypy cffi chardet configobj cryptography decorator gmpy2 idna libnacl lz4 \
meliae netifaces numpy pillow psutil pyasn1 pycparser scipy pyopenssl Twisted==16.4.1 networkx service_identity typing

If you encounter any error during the installation of Pillow, make sure that libjpeg and zlib are installed. They can be installed using:

brew tap homebrew/dupes
brew install libjpeg zlib
brew link --force zlib


git clone --recursive
cd tribler
cp /usr/local/lib/libsodium.dylib ./ || cp /opt/local/lib/libsodium.dylib ./
mkdir vlc
which ffmpeg | xargs -I {} cp "{}" vlc/

Proceed proceed to Build instructions


System Integrity Protection

The security system on MacOS can prevent libsodium.dylib from being dynamically linked into Tribler when running Python. If this library cannot be loaded, it gives an error that libsodium could not be found. This is because the DYLD_LIBRARY_PATH cannot be set when Python starts. More information about this can be read here.

The best solution to this problem is to link or copy libsodium.dylib into the Tribler root directory.


If there are any problems with the guide above, please feel free to fix any errors or create an issue so we can look into it.