Here are some basic instructions on compiling WiiMC. You don’t need to be a programmer to follow these instructions but you should have some basic computer know-how. There are a few reasons you might want to do this:

• To use the latest version (note that beta versions may be unstable)
• To make improvements or fix bugs you have found (please submit these!)
• To make your own custom changes

 

Instructions

This guide provides a cross-platform approach (Windows via MSYS2 or Linux) to setting up a devkitPPC environment specifically for building WiiMC.

1. Install devkitPro

   First, install the devkitPro toolchain manager (pacman):

   • Windows: Download the devkitPro Updater/Installer. Use the defaults to install MSYS2 and the base tools.
   • Linux: Follow the official instructions to add the devkitPro repositories to your package manager.
   
   

   Once installed, open your terminal (MSYS2 terminal on Windows) and run:

   sudo dkp-pacman -S wii-dev # On Windows/MSYS2, call 'pacman' without sudo

   
   
2. Install libogc2

   WiiMC uses libogc2. Follow the official setup guide to install it:

   • Installing libogc2
   
   
3. Install required dependencies (portlibs)

   Install the specific packages required by WiiMC.

   On Linux:

   sudo dkp-pacman -S ppc-libjpeg-turbo ppc-libiconv ppc-libpng ppc-mxml ppc-freetype ppc-libexif

   On Windows/MSYS2:

   pacman -S ppc-libjpeg-turbo ppc-libiconv ppc-libpng ppc-mxml ppc-freetype ppc-libexif

   
   
4. Build & install libntfs dependency

   git clone https://github.com/extremscorner/libntfs.git
   cd libntfs
   make
   sudo -E make install  # On Windows/MSYS2, 'make install' is sufficient

   
   
5. Compile WiiMC

   To build the project, clone the source and run the make command:

   git clone https://github.com/dborth/wiimc.git
   cd wiimc
   make