explaingit

expansionpak/moderngekko-template

Analysis updated 2026-05-18

11MakefileAudience · developerComplexity · 5/5Setup · hard

TLDR

A starter template for turning GameCube and Wii game discs into natively runnable programs through static recompilation, built on the DolRecomp and ModernGekko tools.

Mindmap

mindmap
  root((repo))
    What it does
      Static recompilation template
      Converts DOL to C
      Runs games natively
    Tech stack
      Makefile
      CMake
      DolRecomp
      ModernGekko
    Use cases
      Recompile owned game discs
      Study recompilation pipelines
    Audience
      Hobbyist developers
      Game preservationists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a static recompilation project for a GameCube or Wii game you own.

USE CASE 2

Convert a game disc's original code into C source using DolRecomp.

USE CASE 3

Run recompiled games natively via the ModernGekko runtime instead of emulating them.

USE CASE 4

Learn how console static recompilation pipelines are structured.

What is it built with?

MakefileCMakeCC++Ninja

How does it compare?

expansionpak/moderngekko-templatejohndcode/st3sh2genymobile/genymotion_platform_vendor_genymotion_security_public
Stars111113
LanguageMakefileMakefileMakefile
Last pushed2026-06-03
MaintenanceMaintained
Setup difficultyhardmoderatemoderate
Complexity5/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a legally owned game ISO plus a full C/C++ toolchain (CMake, Ninja, compiler) installed.

In plain English

ModernGekko-Template is a starting point for a specific and technical hobby: turning old GameCube and Wii games into programs that can run natively on a modern computer, instead of being emulated. This process is called static recompilation, and this repository provides the scaffolding to set one up without writing that machinery from scratch. The template relies on two companion projects, called DolRecomp and ModernGekko, which are pulled in automatically as building blocks. DolRecomp takes the original game disc file and converts its code into readable C source code. ModernGekko is the runtime environment that the converted code needs in order to actually run, handling things like video, audio, and other low level game console behavior. This repository itself contains no game specific code, so it works as a blank template that someone can copy and adapt for any GameCube or Wii title they legally own. To use it, a person clicks the Use this template button on GitHub, or clones the repository directly, then points a single command at their own game disc image. The included instructions cover installing the required build tools on Linux, macOS, and Windows, since each operating system needs a slightly different set of compilers and libraries. Once set up, a single command extracts the game, recompiles it, and launches it in a window. The project keeps a separate folder for each game that has been processed, and it remembers earlier work so that running the same game again does not require redoing the whole conversion from scratch. There are also settings for choosing which compiler to use, running in headless mode, and passing extra flags to the underlying tools. This is a niche, technical project aimed at people already comfortable with command line tools, compilers, and game preservation work, rather than a general purpose application for casual users.

Copy-paste prompts

Prompt 1
Help me set up the build dependencies for this Makefile on my operating system.
Prompt 2
Explain what the ISO and GAME variables do in this Makefile.
Prompt 3
Walk me through switching the TOOLCHAIN variable and why it matters on Linux.
Prompt 4
Help me configure controller input for a recompiled GameCube game.

Frequently asked questions

What is moderngekko-template?

A starter template for turning GameCube and Wii game discs into natively runnable programs through static recompilation, built on the DolRecomp and ModernGekko tools.

What language is moderngekko-template written in?

Mainly Makefile. The stack also includes Makefile, CMake, C.

How hard is moderngekko-template to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is moderngekko-template for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.