---

🤯 What Is This?

Halo Mobile takes the Halo: Combat Evolved decompilation and pushes it through a modern browser stack: WebAssembly, WebGL 2, OffscreenCanvas, OPFS, service workers, and a launcher built for phones.

The result is an installable browser game with direct Play controls, private on-device storage, custom touch layouts, controller support, and multiplayer System Link rooms. Yes, that is a campaign-capable Halo port. Yes, that is a browser tab. 🤯

🧠 TL;DR: bring authorized game data, open the launcher, hit Play, and let the browser carry the absurdly large energy sword.

📱 This Is Not A Mockup

🌍 What Can You Do With It?

⚡ Quick Start

The shortest path from clone to “why is Halo running in my browser?”

# 🔓 Get the source
git clone https://github.com/OMG-Guest/Halo-Mobile.git
cd Halo-Mobile

# 🧰 Install and activate Emscripten 6.0.10
git clone --depth 1 https://github.com/emscripten-core/emsdk.git ../emsdk
python3 ../emsdk/emsdk.py install 6.0.10
python3 ../emsdk/emsdk.py activate 6.0.10
source ../emsdk/emsdk_env.sh

# 🚀 Build and test
python3 configure.py --release
ninja web
node --test port/web/tests/*.cjs

The browser app is written to build/web/site. Serve it locally:

# 🌐 Launch a local server
python3 -m http.server --directory build/web/site 8081

Open http://localhost:8081. The service worker reloads once to establish browser isolation. Then you are flying. ✈️

🗺️ Bring Your Own Game Data

The code is here. The game data is not. Keep it that way.

This repository includes zero Halo maps, disc images, saves, credentials, or generated builds. Supply compatible Halo game data only from a source you are authorized to use.

Do not commit map files, disc images, browser saves, credentials, or build output. Ever.

🧱 Architecture

┌──────────────────────────────────────────────────────────┐
│ 📱 Browser launcher                                       │
│ Play • Touch • Controller • Install • System Link rooms  │
└───────────────────────────┬──────────────────────────────┘
                            │
               ┌────────────▼────────────┐
               │ 🌐 Service worker + PWA │
               │ COOP / COEP + offline   │
               └────────────┬────────────┘
                            │
         ┌──────────────────▼──────────────────┐
         │ ⚙️ Emscripten + WebAssembly engine   │
         │ WebGL 2 • worker canvas • audio      │
         └────────┬───────────────────┬─────────┘
                  │                   │
      ┌───────────▼─────────┐ ┌───────▼────────────┐
      │ 💾 OPFS             │ │ 📡 Range map host  │
      │ saves + local maps  │ │ optional streaming │
      └─────────────────────┘ └────────────────────┘

🎯 Requirements

• 🐍 Python 3.10+
• 🔨 Ninja
• 🧪 Emscripten 6.0.10
• 🌐 A current browser with WebGL 2, OffscreenCanvas, SharedArrayBuffer, and OPFS
• 📱 Android Chrome, iOS/iPadOS 17+, or a current desktop browser
• 🔒 HTTPS for mobile network deployment
• 💾 About 2 GB browser storage for a full local map import

For Android USB development:

# 📲 Make the desktop server appear as Android localhost
adb reverse tcp:8081 tcp:8081

Then open http://localhost:8081 in Android Chrome. Use HTTPS—not insecure LAN HTTP—for complete mobile browser capabilities.

🧪 Presentation Modes

Pixels have baggage. Pick your transport.

Direct worker-canvas presentation is the current default. Compare it with ?present=readback when diagnosing device-specific stability or performance.

📁 Project Structure

📦 Halo-Mobile
├── 🌐 port/web/site/      Launcher, PWA shell, controls, service worker
├── 🔌 port/web/src/       Browser and Emscripten platform bridge
├── 🧪 port/web/tests/     Launcher, presenter, and stream-map tests
├── 🧠 source/             Halo decompilation source
├── 🔧 tools/web_build.py  Browser Ninja build graph
└── 📖 LICENSE.md          License and notice material

🐛 Troubleshooting

🤝 Contributing

Fix browser bugs. Improve touch controls. Test weird devices. Make the build more reliable. Keep proprietary game data out of every commit.

Before opening a change:

# ✅ Verify the browser port
node --test port/web/tests/*.cjs

⭐ Star This Repo

If you believe browser games should be allowed to be ridiculous, smash that star button. ⭐