Building RetroArch-Web

Instructions have only been confirmed working for Debian and Fedora.



sudo apt install -y         \
    binutils-mips-linux-gnu \
    build-essential         \
    pkgconf                 \
    python3                 \


sudo dnf groupinstall "Development Tools" "Development Libraries"

To install emscripten, run this command. Note this will only temporarily add emscripten to your path. Follow the on screen directions when it finishes to make this permanent.

cd; && \
git clone .emsdk && \
cd .emsdk && ./emsdk install latest && ./emsdk activate latest && source ./

It is highly recommended to use this scriptopen in new window to compile the cores. It will compile every core and package them for you.

LibRetro "Cores"

  1. Clone the repository.

    git clone

  1. The next steps depend on whether or not you have a Makefile.libretro file.

    • Navigate to the folder with the makefile. If it is not in the base directory, look for a folder named libretro.


    • Build with:

      emmake make -f Makefile.libretro platform=emscripten


    • Build with:

      emmake make platform=emscripten

  1. Copy the .bc file to the RetroArch /dist-cores/ directory and continue to build the wasm files.


  1. Clone the repository.

    git clone

  1. Navigate to /dist-scripts/

  1. Build with:

    emmake ./ emscripten

Last Updated:
Contributors: Ethan O'Brien, Ethan O'Brien, Isaiah Koontz