Skip to content

WaveRace64Recomp Android v0.1.0-alpha.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@HLLArtyParty HLLArtyParty released this 20 Sep 13:12
· 1 commit to main since this release
v0.1.0-alpha.1
bbee01e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

WaveRace64Recomp Android — v0.1.0-alpha.1

The first working Android release of Wave Race 64: Recompiled.

This release is based on the proven v23 Android runtime baseline and is the first build signed with the project's permanent Android release key.

What works

  • Native ARM64 Android build
  • Vulkan rendering through RT64
  • Full-display high-resolution output
  • Widescreen / 16:9 expansion
  • Immersive fullscreen mode
  • ~60 Hz presentation on supported displays
  • Physical game controller support
  • Audio
  • ROM import and verification
  • App-private ROM caching after import
  • Suspend / resume support
  • Persistent crash/runtime logging
  • Wave Race 64 USA Rev A ROM verification

Tested hardware

This release has currently only been tested on an AYN Thor.

Other Android devices, GPU vendors, display configurations and controller setups have not yet been validated. Compatibility reports are welcome.

ROM requirement

No Nintendo ROM or game image is included with this release.

You must provide your own legally obtained copy of:

Wave Race 64 (USA) (Rev A)

The launcher accepts common N64 ROM byte orders and normalizes them internally before verification.

Once a ROM has been successfully imported, the app stores a normalized copy inside its private Android application storage. The original ROM file you selected may then be removed from normal device storage.

Uninstalling the app or clearing its application data will remove the imported private copy and require the ROM to be selected again.

Controls

Current controller mapping is fixed and has primarily been tested with an Xbox Wireless Controller.

Physical controller input N64 input
Left Stick Control Stick
A A Button
X B Button
Menu / Start START
Left Bumper L
Right Bumper R
Left Trigger Z
D-Pad D-Pad
Right Stick C Buttons

The right analog stick acts as the four N64 C buttons based on direction.

Controller remapping is not yet available in this release and is planned for a future version.

Known issues

This is an early alpha release.

Known issues include:

  • Some original 4:3 screen-space effects do not yet cover the full widescreen image.
  • Some menus and 2D layouts expose artifacts typical of forced 4:3 → 16:9 conversion.
  • Dolphin models can exhibit geometry / transform corruption in some scenes.
  • Controller mapping is currently fixed and does not yet have an in-app remapping interface.
  • The launcher/debug interface is still temporary.
  • Some graphics, UI and lifecycle behavior still needs broader device testing.

AI-assisted development

Development of this Android port made extensive use of AI-assisted programming.

AI tools were heavily used for:

  • Code generation
  • Build-system work
  • Source comparison
  • Debugging
  • Android/Vulkan porting analysis
  • Patch development
  • CI workflow development
  • Runtime log analysis
  • Code review and troubleshooting

The port was directed, tested and iterated on by the maintainer using real Android hardware. AI was used extensively as a development tool throughout the porting process.

Acknowledgements

This Android port exists because of the work of the broader N64 recompilation and reverse-engineering community.

Special thanks and credit to:

  • elliotttate/wave-race-64-recomp

    • The upstream Wave Race 64 recompilation project this Android port is based on.
    • Original repository code is licensed under the MIT License.

  • LLONSIT/Wave-Race-64

    • Wave Race 64 decompilation and reference work used by the recompilation project.
    • No explicit top-level license was identified in the pinned revision, so users should refer to the upstream repository for its applicable terms.

  • N64Recomp/N64ModernRuntime

    • Core runtime used by the recompilation.
    • Licensed under GPL-3.0.

  • N64Recomp/RecompFrontend

    • Frontend/runtime support used by the upstream project.
    • No explicit top-level license was identified in the pinned revision; refer to the upstream project and its bundled third-party notices.

  • rt64/rt64

    • N64 graphics renderer used by this project.
    • Licensed under the MIT License.

  • renderbag/plume

    • Rendering hardware interface used by RT64.
    • Licensed under the MIT License.

  • linkzenic/Zelda64Recomp-Android

    • Important Android-porting reference work.
    • Licensed under GPL-3.0.

  • ogdanimal/Goemon64Recomp-Android

    • Major Android-porting reference and donor implementation.
    • Several mature Android patterns were studied and adapted from this project, particularly around native-window ownership, Vulkan surface handling, suspend/resume behavior and Android lifecycle integration.
    • Licensed under GPL-3.0.

  • ogdanimal/rt64

    • Android-specific RT64 reference work used while adapting the rendering stack.

  • ogdanimal/plume

    • Android-specific Plume reference work used while adapting Vulkan/native-window lifecycle handling.

  • SDL2

    • Android window, input and lifecycle layer.
    • This port carries an Android/Vulkan lifecycle adjustment against SDL 2.32.10.

  • FreeType

    • Font rendering dependency.

Thank you to all contributors to the projects above. This Android port builds on a substantial amount of work that existed before it.

Licensing

This repository combines and integrates components with different licenses.

Notable verified licenses include:

  • Wave Race 64: Recompiled original repository code — MIT
  • N64ModernRuntime — GPL-3.0
  • RT64 — MIT
  • Plume — MIT
  • Zelda64Recomp-Android — GPL-3.0
  • Goemon64Recomp-Android — GPL-3.0

Some upstream repositories or bundled third-party components may have separate or additional licensing terms. Refer to the corresponding upstream repositories and included license files for authoritative terms.

Wave Race 64, Nintendo 64, Nintendo and related game content, trademarks and assets are the property of their respective rights holders.

This project does not distribute the original game ROM.

Android signing

This is the first release signed with the project's permanent Android signing identity.

Future releases using the same signing key and a higher Android versionCode should install directly over this release without requiring an uninstall.

Signing certificate SHA-256:

10:8C:5B:42:8B:96:C0:40:61:D3:89:4F:40:F5:EA:76:E6:AE:27:2D:31:18:2A:93:12:D7:D0:AE:E8:5B:83:7A

Build information

  • Version: 0.1.0-alpha.1
  • Android versionCode: 1
  • ABI: arm64-v8a
  • Minimum Android API: 28
  • Runtime baseline: v23 suspend/resume present guard
Assets 3
Loading