Building CEmu

Building CEmu on Linux

Building CEmu on MacOS

Building CEmu on Windows

Old Build Information

Initial note: CEmu uses Animated PNGs ("APNG") to record the screen efficiently. This requires an appropriate libpng version on your system, see this script.

After downloading the source (you can clone the repo or just get the zip):

1. Get the latest Qt5 SDK for your OS.

2. Now you have two options to actually build CEmu:

• In a shell, cd to the project's /gui/qt/ folder and type qmake -r CEmu.pro && make
• Open the .pro file with Qt Creator, set it up (default project settings should be fine), and hit Build.

If you are using linux, use sudo make install to integrate with your desktop.

Build issues and solutions

• If you're on macOS or Linux, you may need to force update your PATH to have Qt's bin/ folder prepended (i.e. edit your shell's profile (for example ~/.bashrc), and add the line:
  export PATH=<path to Qt directory>/bin:$PATH
  You may need to run this command under linux as well: sudo apt-get install git qt5-default

• If you're on macOS or Linux and use Qt Creator, you may need to launch it from the terminal to avoid potential pkg-config issues (for instance, not correctly finding libpng).

• If you're on macOS, CEmu might not launch from Qt Creator, with the default settings. You should then untick some checkboxes in the project's settings.

• If you encounter a build error with something like lto-wrapper failed, try removing the -flto option in the .pro file and rebuild (qmake etc.). It's not clear why this is happening.