Skip to content
Maximilian Downey Twiss edited this page Sep 28, 2022 · 92 revisions

Prerequisites

  • git
  • curl
  • cmake, version 3.13 or newer for Dolphin 5.0-16995 and newer.
  • C++ compiler such as gcc, with C++20 support for Dolphin 5.0-17123 and newer.

Additional Dependencies Examples

For Ubuntu 20.04+ with Dolphin versions ~5.0-13001 or newer

sudo apt install build-essential git cmake ffmpeg libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libevdev-dev libudev-dev libxrandr-dev libxi-dev libpangocairo-1.0-0 qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtbase5-private-dev libbluetooth-dev libasound2-dev libpulse-dev

Other Debian based (Debian, Kali, etc.):

sudo apt install build-essential git cmake ffmpeg libavcodec-dev libevdev-dev libusb-1.0-0-dev libavformat-dev libswscale-dev libsfml-dev libminiupnpc-dev libmbedtls-dev curl libhidapi-dev libpangocairo-1.0-0 libgtk2.0-dev libbluetooth-dev qtchooser qmake6 libudev-dev portaudio19-dev libasound2-dev libzypp-dev libcubeb-dev libfmt-dev llvm-dev

Chrome/Chromium OS (via Chromebrew):

crew install binutils wayland cmake gcc buildessential git libx11 pkg-config libxi libxext qtbase qtwayland mesa libxfixes libxxf86vm libusb libdrm libxrandr gettext linuxheaders enet libxshmfence libunwind lm_sensors elfutils patchelf vulkan_icd_loader

#Intel hardware
crew install xorg_intel_driver

#Nvidia hardware
crew install xorg_nouveau_driver

Checkout Dolphin

  1. git clone --recursive https://github.com/dolphin-emu/dolphin
  2. cd dolphin

Building

Global Build (if unsure, use this option)

mkdir build && cd build

cmake ..

make -j$(nproc)

sudo make install #optional, to install Dolphin

Local Build

mkdir build && cd build

cmake .. -DLINUX_LOCAL_DEV=true

make -j$(nproc)

ln -s ../../Data/Sys Binaries/

Portable Build

mkdir build && cd build

cmake .. -DLINUX_LOCAL_DEV=true

make -j$(nproc)

cp -r ../Data/Sys/ Binaries/

touch Binaries/portable.txt

Distributable .deb Package

following the instructions from the PR where this feature was implemented:

sudo apt install dpkg-dev

mkdir build && cd build

cmake -DCPACK_PACKAGE_CONTACT="Your Name Here" .. #you're responsible for what you distribute

make -j$(nproc)

cpack -G DEB

Externally Managed Packages

On some distributions of Linux, package maintainers provide unmodified builds of Dolphin. These are listed below:

  • Ubuntu as of the time of this writing, 16.04 and 18.04 only, for whatever reason - do NOT use this on anything newer
  • Debian uses a highly outdated 6-year-old build
  • Arch Linux
  • Fedora Follows the latest beta version but isn't quite always caught up with the most recent
  • OpenSUSE
  • Gentoo
  • Flatpak updated with latest "beta" versions

Troubleshooting

  • Ubuntu 18.04 users must install gcc-11 from this PPA and then instead of cmake .. type cmake .. -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11 during the build process.
  • Whenever QT5 support is eventually dropped, the proper QT6 dependencies will need to be installed from source or from a repo (such as this PPA for outdated Ubuntu releases).