EMG is a launcher for mupen64plus and its mupen64plus-ui-console using Electron.

Bundled plugins:

• GFX: Angrylion Plus, GLideN64, Parallel RDP, Rice, Glide64 MK2
• Audio: Mupen64Plus Audio SDL
• Input: GameCube Adapter, Mupen64Plus Input SDL, Raphnetraw
• RSP: Mupen64Plus HLE, Static Interpreter, Parallel RSP

Bundled tools:

• macdylibbundler: Bundle dependencies on macOS
• sdl2-jstest: Configure controller input

System requirements:

• CPU: SSE3 capable (Electron)
• GPU: OpenGL 2.1 (Rice), OpenGL 3.3 (Angrylion Plus, GLideN64), Vulkan 1.1 (Parallel RDP)
• OS: 64-bit version of Windows 7, Linux or macOS 10.13
• Compilation: CMake v3.15 (Ubuntu 20.04, Debian 11 or similar)

GameCube adapter:

Follow the instructions to set up the adapter. Third party adapters may fail to work.

Shortcuts:

• Ctrl + I: Toggle developer tools
• Ctrl + L: Launch mupen64plus
• Ctrl + N: Reset all settings
• Ctrl + O: Open ROM
• Ctrl + R: Reload
• Ctrl + Numpad+: Zoom in
• Ctrl + Numpad-: Zoom out
• Ctrl + Numpad0: Zoom reset

Release files:

Build files:

Can be found in build/EMG after running compile.sh. See below for more details.

Download and install MSYS2. Run MSYS2 MinGW x64 and install dependencies:

pacman -S --needed --noconfirm git make mingw-w64-x86_64-cmake mingw-w64-x86_64-freetype mingw-w64-x86_64-gcc mingw-w64-x86_64-glew mingw-w64-x86_64-hidapi mingw-w64-x86_64-libpng mingw-w64-x86_64-libsamplerate mingw-w64-x86_64-nasm mingw-w64-x86_64-ninja mingw-w64-x86_64-rust mingw-w64-x86_64-SDL2 mingw-w64-x86_64-speex mingw-w64-x86_64-vulkan-headers unzip

Clone repository:

git clone https://github.com/GhostlyDark/EMG

Change directory:

cd EMG

Run compile.sh:

./compile.sh

Install dependencies (including rust):

• Ubuntu/Debian (apt):

  sudo apt install -y build-essential cmake curl freeglut3-dev gcc git libfreetype-dev libgtk-3-dev libhidapi-dev libhidapi-hidraw0 libpng-dev libsamplerate0-dev libsdl2-dev libspeexdsp-dev libvulkan-dev make nasm ninja-build pkg-config unzip wget zlib1g-dev
  

  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
  

  source "$HOME/.cargo/env"
  

• Fedora (dnf):

  sudo dnf -y install cmake curl freeglut-devel freetype-devel gcc gcc-c++ git gtk3-devel hidapi-devel libpng-devel libsamplerate-devel make nasm ninja-build pkgconfig SDL2-devel speexdsp-devel unzip vulkan-devel wget zlib-ng-devel
  

  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
  

  source "$HOME/.cargo/env"
  

• Arch Linux (pacman):

  sudo pacman -S --needed --noconfirm cmake freetype2 gcc git glew hidapi libpng libsamplerate make nasm ninja pkgconf rust sdl2 speex unzip vulkan-headers wget
  

• openSUSE Tumbleweed (zypper):

  sudo zypper -n install SDL2-devel cmake freeglut-devel freetype2-devel gcc gcc-c++ git gtk3-devel libhidapi-devel libhidapi-hidraw0 libpng16-devel libsamplerate-devel make nasm ninja pkgconf-pkg-config rust speex-devel unzip vulkan-devel wget zlib-devel
  

Clone repository:

git clone https://github.com/GhostlyDark/EMG

Change directory:

cd EMG

Make compile.sh executable and run it:

chmod u+x compile.sh

./compile.sh

Download a compatible version of Xcode:

• macOS 10.13: Xcode 10.1
• macOS 10.14: Xcode 11.3.1
• macOS 10.15: Xcode 12.4
• macOS 11: Xcode 13.2.1

If you downloaded an .xip archive, extract and move Xcode.app into the /Applications folder and run it.

sudo rm -rf /Library/Developer/CommandLineTools

xcode-select --install

sudo xcodebuild -license accept

Install MacPorts, start a new terminal session and install dependencies:

sudo port -N install cargo cmake coreutils freeglut freetype git glew gtk3 hidapi libgcc libpng libsamplerate libsdl2 nasm ninja pkgconfig rust speex speexDSP vulkan-headers wget zlib

Reboot terminal and clone the repository:

git clone https://github.com/GhostlyDark/EMG

Change directory:

cd EMG

Make compile.sh executable and run it:

chmod u+x compile.sh

./compile.sh

chmod u+x ./macdep.sh

./macdep.sh

The build script compile.sh can be run with additional parameters:

./compile.sh [threads]

To limit the building process to one thread:

./compile.sh 1

Additionally, changing the boolean values from ON to OFF near the start of compile.sh disables building the corresponding plugins:

parallelRSP="ON"
raphnetraw="ON"
gca="ON"
angrylion="ON"
parallelRDP="ON"
rice="ON"
glide64mk2="ON"

Plugin files are stored in resources/m64p/plugin.

EMG does allow for unknown plugins to be added, as long as they follow the mupen64plus-[type]-[name].[extension] naming scheme.

Accepted plugin types are audio, input, rsp and video.

By default, EMG stores its settings in:

• Windows: %appdata%/EMG
• Linux: $XDG_CONFIG_HOME/EMG or ~/.config/EMG
• macOS: ~/Library/Application Support/EMG

To override the default location, create a folder resources/data.

If that directory exists, EMG settings are instead stored in data/user. At the same time, data/n64 becomes the default directory for mupen64plus configuration, save files and various plugin data (like cache and textures).

The output folder for EMG settings cannot be reconfigured by other means, but the directories for mupen64plus data can still be changed individually, even if portable mode is active.

Delete or rename the data directory to restore the original behavior.

Logging happens once a mupen64plus instance closes successfully. To view the log, open developer tools by pressing Ctrl + I and switch to the Console tab. Right click on the relevant log -> Save as... to save it as text file.