libogc2

libogc2 contains wide-ranging fixes and additions to most subsystems of libogc, provides hardware enablement for most new (and old) Nintendo GameCube accessories on the market or in prototype stage, and enables greater interoperability with Swiss.

It is largely API compatible with libogc 2.1.0 and earlier.

Projects using libogc2

• 240p Test Suite - Video suite for game consoles
• CleanRip - Nintendo GameCube/Wii disc image creation tool
• FCE Ultra GX - Nintendo Entertainment System emulator
• FlippyDrive - Nintendo GameCube optical drive emulator
• GCC Test Suite - Nintendo GameCube controller tester
• GCMM - Nintendo GameCube memory card manager
• gekkoboot - Nintendo GameCube bootloader
• Genesis Plus GX - Sega 8/16-bit emulator
• Scratch Everywhere! - Scratch 3.0 runtime
• Seta GX - Sega Saturn emulator
• Snes9x GX - Super Nintendo Entertainment System emulator
• Swiss - Swiss army knife of GameCube homebrew
• Visual Boy Advance GX - Game Boy Advance emulator
• WakeMii - Alarm clock music player
• Wii64/Cube64 - Nintendo 64 emulator
• WiiSX/CubeSX - PlayStation 1 emulator
• Xeno Crisis - Retro-style arena shooter

Unofficial ports

• ftpii by @leo60228
• MPlayer CE by @SuperrSonic
• Nicky Boom by @emukidid - Side-scrolling platformer
• Raptor: Call of the Shadows by @RetroGamer02 - Vertically scrolling shooter
• RetroArch by @SuperrSonic
• WiiMC by @SuperrSonic

Subprojects

cubeboot-tools, gamecube-examples, gamecube-tools, libansnd, libdvm, libfat, libntfs, opengx, SDL, 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.

No code changes should be necessary when migrating from libfat to libdvm.

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.

GitHub Actions

-    container: devkitpro/devkitppc:latest
+    container: ghcr.io/extremscorner/libogc2:latest

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
sudo -E make uninstall
sudo -E make clean
git pull
make
sudo -E make install

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