Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Peanuts Native

Nintendo Switch games running natively on Android dual-screen handhelds, with a live companion on the second screen.

status license platform

Discord Ko-fi

[!NOTE] Peanuts Native is in development. The current release is on the releases page. It is not affiliated with Nintendo.

What it is

Peanuts Native turns a dump of a Switch 1 game you own into an Android app on your phone. It is not an emulator. The game's own ARM64 code is rewritten to run directly on the phone's CPU, its graphics are replayed on Vulkan, and its shaders are translated on the device. Everything happens on the phone: you pick the game file, tap Build, and play.

On a dual-screen handheld such as the AYN Thor, the game plays on the top screen and the bottom screen shows a companion for that game: a map, your party, items or quests, read live from the running game and touchable. Companions use the same package format as Eden Duo, so every Eden Duo companion works here too.

Supported games

These are the Switch 1 games this app version includes. The last column says what was seen on an AYN Thor: a game marked "new" was played there for a short time only, and the last two have not been run on a device yet. Kirby's Return to Dream Land Deluxe was run by its contributor on their own AYN Thor only. The Companion column says whether the game has a companion that was checked with it. Use the game update listed. The app shows which update you have and which one a game supports, and asks before building any other.

GameTitle IDGame updateCompanionRuns at
The Legend of Zelda: Link's Awakening01006BB00C6F00001.1.0Yes60 fps
The Legend of Zelda: Echoes of Wisdom01008CF01BAAC0001.1.0Yes60 fps
Fire Emblem: Three Houses010055D009F780001.2.0Yes60 fps
Fire Emblem Engage0100A6301214E0002.0.0Yes60 fps
Metroid Dread010093801237C0002.1.0Yes60 fps
Super Mario Odyssey01000000000100001.4.1Yes60 fps
Mario Kart 8 Deluxe01001520000220004.0.0, 4.0.1Yes60 fps
Animal Crossing: New Horizons01006F80023260003.0.3Yes30 fps, as on Switch
Persona 5 Royal01005CA01580E0001.0.2Yes60 fps
Castlevania: Belmont's Curse0100BA4026E940001.1.0Yes60 fps
OCTOPATH TRAVELER 001005270232F20001.0.5Yes60 fps
Pokémon Brilliant Diamond0100000011D900001.3.0Yes60 fps
Pokémon Shining Pearl010018E011D920001.3.0Not checked60 fps; new, little tested
Pokémon Sword0100ABF0089680001.3.2Yes60 fps (30 on Switch)
Pokémon Shield01008DB008C2C0001.3.2Yes60 fps (30 on Switch); new, little tested
The Legend of Zelda: Breath of the Wild01007EF00011E0001.9.0Yes60 fps (30 on Switch); new, little tested
FINAL FANTASY RESONANCE0100606026F120001.0.1No45 to 60 fps; new, little tested
The Legend of Zelda: Skyward Sword HD01002DA0134840001.0.1Not checked60 fps; new: right indoors, the fog outdoors is not checked and may draw wrong
Pokémon Legends: Arceus01001F5010DFA0001.1.1No30 fps, as on Switch; new, little tested
Resident Evil 4010099A00BC1E000v131072Not checked60 fps; new, a first profile: the first scenes only
Kirby's Return to Dream Land Deluxe01006B601380E0001.0.0 (base game)Yes50 to 60 fps; new, little tested: its first stage, by its contributor
Super Mario Bros. Wonder010015100B5140001.0.0, 1.0.1, 1.2.1Not checkedNot tested on a device yet
DRAGON QUEST III HD-2D Remake01003E601E3240001.1.2 onlyNot checkedNot tested on a device yet

What you need

  • A dual-screen Android handheld. Peanuts Native is developed and tested on the AYN Thor. On a single-screen phone the game still runs, without the companion.
  • Android 13 or later, a Snapdragon GPU with Vulkan 1.3, and 12 GB of RAM or more. A Turnip Vulkan driver is recommended; the app can download one.
  • Free storage for the game and its build. Plan for the size of the game plus a few GB.
  • Your own prod.keys, your own firmware dump (a folder or a .zip) and your own game dump (NSP, XCI or a dump folder), with its update.

Your keys and games

Peanuts Native only runs games you dumped from your own console, with keys from that console. It contains no Nintendo code, firmware or keys, never downloads any, and does not link to places that offer them. Nobody from this project will ever ask you for money, keys or game files.

Getting started

  1. Install the APK and allow All files access when asked.
  2. On the first screen, add your Keys (prod.keys), pick your Game folder, and add your Firmware. Both keys and firmware are needed before the first build. A build folder is optional (Settings, Library, Build folder): pick one, on the phone or the microSD card, to keep every build there, organized by title ID.
  3. Open a game from the library and tap Build. The app imports the game, rewrites its code, translates its shaders and installs its companion. Most games take 5 to 40 minutes on the Thor.
  4. Tap the game to play. The companion starts on the bottom screen.

Hold a game's cover to open its own page: picture and speed settings, mods, the companion, saves and storage. After an app update, rebuilding every game is strongly recommended: hold the cover, open Storage, tap Build again, then Rebuild.

Settings worth knowing

  • Console mode: Docked or Handheld, for all games in Settings and per game on its page. It can also be changed while the game runs, from the in-game panel.
  • Resolution scale (first version): 0.5x to 2x of the size the game draws at. Not every effect follows it.
  • Mods (first version): hold the cover, Game tab, Mods. Install a mod from a folder or a zip. It is on from the game's next start, and each mod has a switch and a delete button. A mod that changes the game's code gets a build with mods, which starts by itself (it waits while another build runs). Until that build is ready, the game starts without that mod. After a failed build, tap Build with mods to try again.
  • Saves: back up, restore, import and Delete save data on the game's Saves tab.

A game can also be built on a computer and pushed to the device: see BUILDER.md. The builder is tested on macOS and Linux. Windows is written but not tested yet. On Linux it also builds four games whose shaders are Oodle-compressed or in Unreal archives; for the Oodle ones it compiles a separate open-source decoder (ooz, GPL-3.0-or-later), which is used on the computer only and is not part of the app.

Companions

Open Settings, then Companions, to see every companion and every release of it. You can install, update, remove or roll back to an earlier release, and each download is checked against its published checksum before it is used. A game without a companion leaves the bottom screen free for Android. Companion screens give haptic feedback when you tap them.

The companions themselves are published in eden-duo-companions, with screenshots and what each one shows.

FAQ

Is this piracy? No. It runs only a dump of a game you own, made from your own console, and ships no game code, firmware or keys.

My game update is different from the table. Will it work? The game's page tells you. Some games support more than one update; others need the exact one listed. For an unsupported update the app asks before building, and the result may not start.

Can I share my built game or its shaders? No. Both are made from your own game's files. Share nothing derived from a game, and point other players to their own dump instead.

Does the companion slow the game down? Very little. The games above hold their frame rate with the companion running.

More questions and troubleshooting: FAQ.md.

Contributing

See CONTRIBUTING.md for adding a game, fixing a bug and testing on a device. Run sh peanuts/scripts/install-hooks.sh once after cloning.

Credits and license

Peanuts Native is a fork of Banana Native by moceure, which does the real work of running Switch games natively on Android and is built on nxnative by seedds (MIT). Some fixes are adapted from nx2android (MIT).

The companion runtime and package format come from Eden Duo.

Contributors: the builder for PC, Mac and Linux (peanuts/docs/BUILDER.md) is by intermission88 (pull request #13), and so are the profile of Kirby's Return to Dream Land Deluxe and the guide for adding a game (peanuts/docs/NEW-GAME.md, pull request #34). The issue and discussion forms were set right by ArchOwlen (pull request #5).

The project as a whole is licensed GPL-3.0-or-later. Frame generation (ported from Eden and lsfg-vk) and other components carry their own licenses; see android/NOTICE.md and dm/third_party/README.md.

关于 About

No description, website, or topics provided.

语言 Languages

C39.1%
Python20.8%
Java12.4%
Objective-C11.5%
C++11.4%
Assembly1.7%
Roff1.3%
Shell0.5%
Makefile0.4%
M0.2%
Swift0.2%
C#0.2%
CMake0.2%
Metal0.1%
Wolfram Language0.0%
GLSL0.0%
PowerShell0.0%
Batchfile0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
252
Total Commits
峰值: 252次/周
Less
More

核心贡献者 Contributors