Mario64 — Render96ex / SM64EX + Odyssey Installer for Linux

Why this installer?

The official OMM build is manual and fragile. This automates it end-to-end.

⚡

One command

Detects your distro, installs deps, clones, patches, builds and installs. No manual steps.

🧹

Temp build, clean output

Clone & compilation happen in /tmp and are deleted. Only the game stays in ~/Mario64.

🎨

Render96 HD + Odyssey

Choose Render96ex or SM64EX — both get Render96 HD textures & models + full Odyssey moveset (Cappy, captures, roll, dive, cap bounce).

🧠

Smart & safe

ROM hash verified, patch rejects detected, defensive fixes for the star-crash bug, idempotent re-runs.

How it works

What happens when you run the installer.

1 — Choose base

Pick 1 Render96ex (recommended, tester) or 2 SM64EX (master) — or set ENGINE=render96|sm64ex to skip the prompt. Both get Render96 HD packs.

2 — Dependencies

Detects pacman / apt / dnf / zypper and installs git curl make gcc python3 SDL2 GLEW p7zip (skip with SKIP_DEPS=1).

3 — ROM

Uses ROM_ZIP if set, otherwise scans the script dir. If not found, prompts for the path (drag & drop) or auto-searches ~/Downloads, ~/ROMs, ~/Games etc.

4 — Install location

Prompts for the install folder — leave empty for ~/Mario64. Override with FINAL_DIR=~/Games/Mario64.

5 — Build in temp

Clones the chosen base (Render96/Render96ex or sm64pc/sm64ex), applies omm.patch + defensive fixes, builds with make -j$(nproc) — all inside /tmp/mario64_build_XXXXXX.

6 — Deliver & clean

Moves build/us_pc to the chosen folder, installs Render96 HD packs (both engines), creates launch.sh + desktop entry, then deletes the temp dir.

Output: ~/Mario64/build/us_pc/sm64.r96x (or sm64.us.f3dex2e for SM64EX) · ~/Mario64/launch.sh · ~/.local/bin/render96-odyssey or sm64ex-odyssey · desktop entry in your app menu.

Install options

curl -fsSL https://raw.githubusercontent.com/zonaro/Mario64/main/install.sh -o install.sh && chmod +x install.sh && ./install.sh # piped (also prompts via /dev/tty): bash -c "$(curl -fsSL https://raw.githubusercontent.com/zonaro/Mario64/main/install.sh)" # non-interactive — pick base + ROM + dir: ENGINE=render96 ROM_ZIP=~/roms/sm64.z64 FINAL_DIR=~/Mario64 bash -c "$(curl -fsSL https://raw.githubusercontent.com/zonaro/Mario64/main/install.sh)" ENGINE=sm64ex FINAL_DIR=~/Games/Mario64 ./install.sh # ENGINE aliases: r96/render96ex → render96, ex/sm64 → sm64ex

Variable	Default	Description
`ENGINE`	prompt (`render96`)	`render96` (Render96ex) or `sm64ex` — aliases: `r96`, `ex`, `sm64`; also `BASE`/`R96`/`SM64EX`
`ROM_ZIP`	auto-detect / prompt	Path to `.z64` / `.n64` / `.v64` / `.zip`
`FINAL_DIR`	`~/Mario64`	Install folder (prompt; empty = `~/Mario64`)
`BRANCH`	`tester` (r96) / `master` (ex)	Base branch (override per engine)
`JOBS`	`nproc`	Parallel make jobs
`SKIP_DEPS`	`0`	`1` to skip dep install
`SKIP_MODELS`	`0`	`1` to skip model packs
`FORCE`	`0`	`1` to force clean rebuild

First run

🎨 HD textures/models

Already installed for both bases (Render96 packs).

🧢 Render96ex

Pause → DynOS → Packs → enable Render96_DynOS_v3.25

📦 SM64EX / OMM

Options → Model Packs → Render96_DynOs_v3.25

🕹️ Controls

Options → Controls — keyboard or gamepad

~/Mario64/launch.sh # or render96-odyssey # Render96ex sm64ex-odyssey # SM64EX # or from your app menu: Super Mario 64 — Render96 EX (Odyssey) / SM64EX (Odyssey + Render96 HD)

Requirements

Linux · unmodified Super Mario 64 (US) ROM · build tools auto-installed

The build verifies the ROM SHA1 (9bef1128717f958171a4afac3ed78ee2bb4e86ce) and aborts on a hacked/extended ROM. PortMaster is not used — it targets handheld CFWs and has no desktop Linux port for Render96ex.