README.md

libogc2

Projects using libogc2

• 240p Test Suite - Video suite for game consoles
• CleanRip - GameCube/Wii disc image creation tool
• FlippyDrive - GameCube optical drive emulator
• GCMM - GameCube memory card manager
• gekkoboot - GameCube bootloader
• Seta GX - Sega Saturn emulator
• Swiss - Swiss army knife of GameCube homebrew
• Wii64/Cube64 - Nintendo 64 emulator
• WiiSX/CubeSX - PlayStation 1 emulator
• Xeno Crisis - Retro-style arena shooter

Subprojects

cubeboot-tools, gamecube-examples, gamecube-tools, libdvm, libfat, libntfs, wii-examples

Installing

Follow the instructions from pacman-packages.

sudo (dkp-)pacman -S libogc2 libogc2-docs libogc2-examples

When asked for a libogc2-libfat provider, libogc2-libdvm is generally preferred, but libogc2-libfat may be chosen if you have concerns regarding exFAT's legal status. If you have a need for libogc2-libdvm without exFAT support, please open an issue.

Migrating from libogc

GNU Make

-include $(DEVKITPPC)/gamecube_rules
+include $(DEVKITPRO)/libogc2/gamecube_rules

-include $(DEVKITPPC)/wii_rules
+include $(DEVKITPRO)/libogc2/wii_rules

CMake

sudo (dkp-)pacman -S libogc2-cmake

DKP_OGC_PLATFORM_LIBRARY may be set to libogc or libogc2 to build projects using either thereafter.

Building

1. Existing packages should first be uninstalled if already installed.

   sudo (dkp-)pacman -R --cascade libogc2(-git)
   

2. Install build dependencies.

   sudo (dkp-)pacman -S --needed devkitPPC gamecube-tools ppc-libmad
   

3. Clone and build source repositories.

   git clone https://github.com/extremscorner/libogc2.git
   cd libogc2
   make
   sudo -E make install
   

   git clone https://github.com/extremscorner/libfat.git
   cd libfat
   make ogc-release
   sudo -E make ogc-install
   

Using sudo is not necessary with MSYS2.

Upgrading

sudo (dkp-)pacman -Syu

cd libogc2
git pull
sudo -E make uninstall
sudo -E make clean
make
sudo -E make install

cd libfat
git pull
make ogc-clean
make ogc-release
sudo -E make ogc-install