OpenPort-Labs/Galaxy-Android

Play the classic 3D cosmic gravity platformer natively on your Android phone, tablet, or handheld console.

Galaxy Android is a 100% native Android ARM64 port, compiled directly from reconstructed C++ source code. Maintained by OpenPort Labs.

It is not an emulator: the game code executes natively on your phone's processor using OpenGL ES 3.2 (with experimental Vulkan 1.1) and AAudio, delivering fluid 60 FPS performance, low battery consumption, and zero emulation overhead.

This project is made possible through the pioneering work of the community:

• bigmak94 / GalaxyQuest: For the standalone mobile/ARM port architecture, memory reservation shims, and the little-endian asset cooker toolchain.
• Petari Decompilation Project: For the reverse-engineering and C++ decompilation research.

We express our deepest thanks to both projects and their contributors for keeping game preservation alive.

• Save your game progress at any point during gameplay without returning to the Comet Observatory or waiting for a level-complete star!
• Accessible directly from the slide-out Settings Drawer (⚙ -> ⚡ Quick Save Anywhere) with a floating animated on-screen HUD toast ("Game Progress Saved Anywhere!").
• Safely writes full user file data, star bit counts, coin tallies, comet timers, and unlocked galaxies directly to internal NAND storage.

• OpenGL ES 3.2 Backend (Default & Recommended): Production-ready renderer featuring dynamic TEV stage compilation, Mali & Adreno lighting safeguards, non-zero vector normalization guards, and indirect texture coordinate warping.
• Vulkan 1.1 Hardware Backend (Experimental WIP): Next-generation low-overhead Vulkan backend. Hardware probing, swapchain management, dynamic depth format selection, and fence synchronization are in place; full GX draw record playback is actively in progress.

• Native plug-and-play support for Bluetooth and USB gamepads (Xbox Wireless, PlayStation DualSense / DualShock 4, Switch Pro, Razer Kishi, Backbone One, etc.).
• Manifest declarations configured with android.hardware.touchscreen optional (required="false") and android.hardware.gamepad enabled, ensuring complete compatibility with Android TV, dedicated handhelds (Odin, Retroid Pocket, Logitech G Cloud), and external monitors.

• Sleek Translucent Dark Glass Theme: Semi-transparent frosted glass backplates with ultra-thin luminous perimeter rings and tactile depression feedback.
• Dynamic Luminous Laser Tether Joystick: Vector laser line connects the stick origin to your thumb knob, providing immediate visual feedback of analog magnitude and deflection angle. Supports dynamic floating stick anchor mode.
• Directional Camera D-Pad: Unibody circular navigation disc replicating the controller D-Pad for 45° camera rotation and recentering.
• Direct 1:1 Star Pointer Finger Tracking: Touch and drag anywhere on screen to collect and aim star bits without accidental joystick conflicts.

• Dynamically adapts the 3D camera projection to modern mobile aspect ratios (such as 19.5:9, 20:9, and foldable aspect ratios).
• Horizontally expands field of view (Hor+) so you see more of the cosmos around the player without vertical cropping.
• Keeps 2D HUD elements (health meter, coin counters, star bit count, dialogs) centered in a 16:9 safe zone so circular UI elements remain perfect circles and are never obscured by camera hole-punch cutouts or rounded screen corners.

• Slide-out drawer docked cleanly on the top-left edge of the screen (⚙).
• Native Hor+ Ultrawide toggle, button opacity, button scaling, joystick modes, drag-and-drop touch layout editor, and Quick Save Anywhere.
• Built-in gameplay options and accessibility settings.

• Software-decoded THP video playback for the prologue and ending cinematics.
• Real-time DSP mixer running through Android's low-latency AAudio subsystem.

For detailed instructions, see the complete Installation Guide.

With the unified GalaxyAndroid package:

1. Place your game dump on your phone:
   • Copy your legally dumped optical disc image (.rvz, .wbfs, .iso, or .wia) into your phone's Download folder.
2. Install the unified APK:
   • Install GalaxyAndroid.apk.
3. Launch & Play:
   • Enjoy native 60 FPS gameplay on Android!

• Controls & Input Reference - Touch overlay, pointer aim, and gamepad layouts
• Technical Architecture - 32-bit address space reservation, GLES 3.2 translation, and Hor+ ultrawide
• Installation Guide - Comprehensive setup instructions
• Desktop Pipeline Guide - Automated PC extraction and conversion
• Decompilation Notes - Decompilation symbol mappings and splits

• Android NDK r25 or r26
• Android SDK (API 30+ and Build-Tools 34+)
• CMake 3.22+ and Ninja
• JDK 17+ and Python 3.8+

# 1. Compile native engine library (libgame.so)
cmake --build build-mobile --target game

# 2. Package and sign APK
python package_mobile_apk.py

The output APK is generated at out-mobile/GalaxyAndroid.apk.

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.