FCEUX

sdl2 - Version = 2.0 (sdl2 = 2.8 recommended) cmake - Required to build fceux. (cmake = 3.8 recommended) qt5 OR qt6 - (qt version = 5.11 recommended) Required Qt Modules: Widgets and OpenGL Optional Qt Modules: Help liblua5.1 (optional) - Will statically link internally if the system cannot provide this. libx264 (optional) - H.264 video encoder for avi recording (recommended) libx265 (optional) - H.265 video encoder for avi recording (recommended) ffmpeg libraries (optional) - for avi recording (recommended) ffmpeg libraries used: libavcodec libavformat libavutil libswresample libswscale libarchive (optional) - for 7zip archive support (test with version 3.4.0) minizip zlib openGL c++ compiler -- you may use g++ from gcc or clang++ from llvm or msvc 2019 The old scons build system is no longer supported. Fceux can be compiled and built using the cmake build system. To compile, run: mkdir build; cd build; cmake -DCMAKE INSTALL PREFIX=/usr -DCMAKE BUILD TYPE=Release .. For a release build The Qt version of the GUI builds by default and this is the preferred GUI for use. For those who must have GTK/Gnome style, there is a GTK style plugin for Qt that can be installed to the OS and selected for use via the GUI. The previous GTK version of the GUI is now retired and has been removed from the build. The Qt version GUI by far exceeds the old GTK gui in capability and performance. The Qt GUI can build/link against both Qt5 and Qt6. To enable building against Qt6, use -DQT6=1 argument: cmake -DCMAKE INSTALL PREFIX=/usr -DQT6=1 -DCMAKE BUILD TYPE=Debug .. After a sucessful compilation, the fceux binary will be generated to ./build/src/fceux . You can install fceux to your system with the following command: You can enable and disable certain features of fceux at build time. Look in the src/CMakeList.txt file to tweak options. The Qt GUI is required and automatically builds as part of the build. The Qt GUI is the default. When invoking cmake, Qt6 can be used (instead of Qt5) by specifying a -DQT6=1 on the command line. See above build instructions. OpenGL options: For Linux builds, the OpenGL library preference can be either GLVND or LEGACY (default). To use GLVND OpenGL, add a -DGLVND=1 on the cmake command line. Qt Help Engine options: The GUI supports both online and offline documentation options. Online documentation requires an internet connection and a browser. Qt supports an help engine that can read compiled html files (made via the Qt qhelpgenerator tool), these files can reside locally on ones computer and be accessed by the GUI using the Qt help engine module. The Qt help engine is an optional dependency and can be enabled in the build by adding a -DQHELP=1 on the cmake command line. In addition, some of the lua scripts require functionality from the "iup" GUI library. You can obtain binaries and source for "iup" upstream ( but I would recommend obtaining packages from your Linux distribution if you are able, as it can be difficult to compile or get the binaries working correctly on a given system. You will need to add the location that the libiup .so files to the LUA CPATH. This can be done with the following command (please note that the location where iup is installed with vary based on how you installed iup): Finally, if any scripts complaints about "attempt to index global 'iup' (a nil value)", this means that "iup" needs to be explicitly loaded into the script. You can add the following line to the head of script to manually load "iup": Running fceux through esddsp is known to fix some audio issues with pulseaudio on some older Ubuntu versions. If you have an issue with fceux, report it in the github bug tracker (see fceux at github.com). If you would like to contact the author of this readme personally, e-mail LTsmooth42 gmail com. You can also check us out at fceu on irc.freenode.net.