Skip to content

About

Banana Native fork: native aspect switch (16:9 / 4:3), FSR 3.1 upscaling, readable small text

Resources

Contributing

Stars

7 stars

Watchers

1 watching

Forks

Repository files navigation

Banana Native logo

Banana Native

Banana Native runs Switch 2 games from your own dumps on Android phones. Like Wine, it emulates no hardware: the game's own ARM64 code runs on the phone's CPU, Banana Native supplies the system services it calls and translates its graphics to Vulkan. It is an Android port of nxnative by seedds.

Note

Unofficial and experimental. Not affiliated with Nintendo, nxnative or Eden. The project contains no Nintendo code, firmware or keys and decrypts nothing: it reads only a dump of a game you own, made from your own console. Most of the code was written with an AI coding assistant (Claude) and tested by hand. More.

Games

Game Version Status Notes
Donkey Kong Bananza (040074A01BF12000) update 458752 Supported 30 fps
Mario Kart World (0400C3F00006E000) 1.8.0 Supported a phone cooler is recommended
Pokémon Pokopia (0400A3A01EE4C000) update 655360 (Ver. 2.0.1) Supported about 60 fps
The Legend of Zelda: Ocarina of Time (0400486024DEC000) 2.0 Experimental plays, with visual glitches (too bright, mesh foliage missing); system driver only
Splatoon Raiders (0400380020056000) update 65536 Experimental boots and runs, but not playable yet (very low frame rate)

The app tells you if your dump is another version. Splatoon Raiders is not playable yet: it boots and runs at a very low frame rate, and ships so that people can test it and help. Ocarina of Time: only version 2.0 is tested; the first starts are slow (minutes of loading, then low fps and black frames) until the GPU driver's pipeline cache fills. Experimental games has their known problems and how to help.

What you need

  • An Android 13+ phone with a Snapdragon (Adreno) GPU and at least 12 GB of RAM, 16 GB for Mario Kart World (0400C3F00006E000). Tested on a Snapdragon 8 Elite Gen 5 with 16 GB, with the phone's own Qualcomm (system) driver and Turnip.
  • Your own dump of the game, as a folder (or a .nup file of one): base/, and updates/<version>/ and dlc/ if you have them, each with exefs/ and romfs/. NSP and XCI files don't work.
  • Recommended: a Windows PC or a Mac, and a phone cooler.

Setup

Each game is prepared once into a pack (its code rewritten for Android, its shaders translated for Vulkan). A computer does this much faster than the phone.

First install the APK from Releases (or the mirror on git.eden-emu.dev) and allow All files access.

PC (Windows) or Mac (guide). Mac: tested. Windows: new and not yet tested on a real PC — please report how it goes.

  1. Download this repository and double-click scripts\bananative.bat (Windows) or scripts/bananative.command (Mac). The first time, it installs its tools (about 400 MB) into a folder you pick.
  2. Pick the game (its folder or .nup file) and click Prepare.
  3. Copy the game folder to the phone, and the pack next to it: <title ID>-work/android-pack.
  4. In the app, tap Add game and pick the game folder. It finds the pack. (Or use Import pack… with the pack folder.)

Phone only (guide): copy the game folder to the phone, tap Add game, then Prepare. It runs in the background and can be paused; keep the phone on the charger. The first Prepare takes about 20–45 minutes (mostly translating shaders). Prepare is incremental: later runs reuse existing shaders and only rewrite code when its key changes (a few minutes). A computer is recommended for Mario Kart World (0400C3F00006E000).

Problems

  • Settings › Readiness check says what your phone is missing and fixes most items.
  • A game's ⋯ button › Share log shares its log.
  • Open an issue with the form; questions go to Discussions. More: Troubleshooting.

Important

The official places for Banana Native are this GitHub repository and its mirror on git.eden-emu.dev: download the APK only from their releases. Nobody from the project will ask you for money, keys or game files.

Guides

Getting started · PC or Mac · Storage access · Saves · Packs and app updates · GPU drivers · Troubleshooting · Experimental games

More

Features · Performance · How it works · About the project · Videos and device reports · History

Contributing

Each game's note says what is known and what is open (games table); working on the code: docs/agents, android/README.md. The experimental games need the most help: see the issues marked help wanted.

Licence and credits

The Android app is GPL-3.0-or-later as a whole; nxnative's own files keep their MIT licence. See android/NOTICE.md and the credits.

Use games you own. Please don't ask for games, keys or dumps.

About

Banana Native fork: native aspect switch (16:9 / 4:3), FSR 3.1 upscaling, readable small text

Resources

Contributing

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages