r/MiyooMini • • 1h ago

Ports Perfect Dark is out on the Miyoo Mini (native port, no emulation) + proper Mini Flip / v4 full-screen support and fixes to all 9 other N64 games

Post image
• Upvotes

Hey all! Big update today: Perfect Dark is out as the 10th native N64 port, every game now properly fills the Mini Flip / Mini v4 screen, and all nine other games got fixes. Same as the others, Perfect Dark is a native port built from the decompilation, not an emulator, so it runs the game's own code directly on the Mini.

Download: https://miyoo-n64.pages.dev (Bring your own ROM: Perfect Dark (USA) Rev 1, as a .z64 dump (the site has the exact version)).

If the link above doesn't work, grab them directly from GitHub: https://github.com/mr-finster/miyoo64/releases/latest

What you get

  • The full solo campaign, every mission
  • Save states (9 slots plus an auto save) and resume after a power-off, same menu as the other games (MENU button)
  • Missions unlock as you play, like on the N64 (want everything open? set Game.UnlockAll=1 in App/PerfectDark/data/pd.ini after the first start)
  • GoldenEye-style controls tuned for the Mini (hold Y to aim with the d-pad, L1/R1 strafe), full list on the site
  • Plays smooth on the Mini, the busiest firefights can dip a bit

Also in this update (all games)

  • Proper Mini Flip and Mini v4 support. Every game now fills the whole bigger screen instead of sitting in the middle with a border. I don't have a Flip to test on, so if you do, let me know how it goes (and if it ever looks wrong, <GAME>_FLIPFILL=0 in the game's launch.sh brings back the old picture).
  • Fixed: the black border on the Mini v4. Some of you saw the picture shrink with a black border around it, on and off (thanks u/The_Shoe1990 for the details!). The v4's screen is sometimes left in its bigger mode by whatever ran before, and the games drew a smaller picture in that mode. Now it's full screen every time.
  • Fixes checked against the N64 for every game. I went through all nine with a cycle-accurate N64 emulator side by side with the Miyoo builds and fixed what didn't match:
    • Paper Mario: the glows are back (Star Rod, Kammy's orb, lightning flashes), the Star Spirits' glow cloud is white, and no more white box on Bowser's face in the intro.
    • F-Zero X: machine decals no longer paint wrong-coloured panels, the red attack rim shows, the static fade into a race and explosion debris look like the N64.
    • Star Fox 64: space and fades are the N64's dark grey instead of pure black.
    • GoldenEye: the shadows on the Runway snow are soft ovals again instead of dark blocks.
    • The rest (Mario Kart 64, Diddy Kong Racing, Ocarina of Time, Smash Bros., Super Mario 64) already matched.
  • Nothing changes on a regular Mini or Mini Plus apart from those fixes: same picture, pixel for pixel.
  • Changelog and known issues for every game are on the site now (under each game's Download).
  • Ports section on Onion: the games already show up in Ports as well as Apps (turn on the Ports Collection in Apps > Package Manager if you don't see it). Want them in Ports only? Delete config.json in App/<Game>.
  • To update, just unzip the new zips over the old ones: your saves carry over.

How it was made (short version)

Perfect Dark has a full decompilation (the game's code rebuilt as C by the community) and a PC port built on it. I swapped the PC port's OpenGL renderer for the software renderer from the other Miyoo ports, which draws using both of the Mini's cores, and got audio, controls and save states working.

Then I went through the solo missions one by one: for each of the 20 main missions I captured the intro and the start of gameplay on a cycle-accurate N64 emulator and in the Miyoo port, matched them frame by frame and fixed anything that didn't line up. Things that got fixed along the way: the cutscene static (it now reads the game's memory like the N64 does instead of being plain noise), night vision and infrared, sun flares showing through walls, the health bar box, dark menu text, black frames after the inventory, plus audio crackle and a resume crash.

What's next, what might happen, and what can't

Every one of these ports is built on a finished (or nearly finished) decompilation, so that's what decides what's on the list. Here's the short version:

Games / features Why
Next Button remapping in the menu
Importing emulator saves (.sav/.srm/.fla)
Good candidates Majora's Mask, Banjo-Kazooie, Doom 64, Pilotwings 64, Pokémon Snap, Dr. Mario 64, Harvest Moon 64, Snowboard Kids 1 & 2, Excitebike 64, The New Tetris
Possible later Donkey Kong 64, Kirby 64, Conker's Bad Fur Day, Pokémon Stadium, Wave Race 64, Body Harvest, Blast Corps
Needs a decomp first Banjo-Tooie, Jet Force Gemini, Mario Party 1–3, 1080° Snowboarding, Rogue Squadron, Star Wars Episode I: Racer
Not possible 4-player split screen / multiplayer
The PC "Recompiled" versions (Zelda 64: Recompiled etc.)

The full list of 111 N64 games, with where each decomp is at and a link to it, is here: https://miyoo-n64.pages.dev/outlook

If your favourite isn't on there, it almost certainly doesn't have a decomp yet. Once one gets finished I'm happy to take a look!

Big thanks to the decomp communities for making all of this possible, and to everyone who's been testing. 😊


r/MiyooMini • • 6h ago

Apps Homebrew ROMs added to Mixtape

Thumbnail
gallery
54 Upvotes

Hey, everyone. Someone told me you clowns were actually playing games on your devices (crazy!) and were running out of games to play. I added a tab for Homebrew ROMs from that pulls its entries from Homebrew Hub, so you should never run out of games to play now. It's live on Mixtape now, so press select inside the app to update to the latest version.

Also in the Mixtape menu you'll see an option to add a Mixtape theme to Onion's theme tool and also an option to add Mixtape to the game consoles which enables you to place it in the favorites folder. Totally optional of course.

I've tested it and it's working well for me. First time you launch it may take a few minutes to sync the Homebrew Hub catalog, so just be patient. Full disclosure as always, this was built with Claude, so if you're not into that then feel free to pass. Hope you guys enjoy!


r/MiyooMini • • 14h ago

Lounge Miyoo Mini Plus spotted on official Samsung website

Thumbnail
gallery
137 Upvotes

They are showing the MMP as a use-case for their new T7 microSD cards.


r/MiyooMini • • 17h ago

Lounge Have I gone too far? Where are the most unusual places you guys play? And what would you say if you found out your pilot is playing during cruise?

Post image
42 Upvotes

r/MiyooMini • • 1d ago

Mini+ Miyoo Mini + GB / GBP / GBC Overlays

Thumbnail
gallery
213 Upvotes

Continuing from my previous post, I’ve finished (for now) my GB overlays. Due to copyright reasons, I renamed them, but their purpose remains the same.

Please note that these are strictly built for the Miyoo Mini Plus due to the specific display resolution.

Set your RetroArch video filter to "Filters for Overlays/GB_noGrid".

Note on the pixel grid: The grid is drawn directly into the overlays, so no extra grid shader is needed.

Recommended Gambatte core settings:

GB Colorization: OFF

Color Correction: Always (Accurate)

Interframe Blending / LCD Ghosting: Accurate

Dark Filter: 0%

Download Link: https://github.com/SebVFX/Overlays-Retroarch/raw/b0a14573dac22e0dd25db07b3011ff87dfacdf91/mini%20plus%20overlays.zip

Hope you enjoy them. I tried to make them look as close to the originals as possible without being too distracting.

Let me know what you think.


r/MiyooMini • • 22h ago

Help Needed! Stuttering and Frame Hitching on Retroarch

Enable HLS to view with audio, or disable this notification

11 Upvotes

On my Miyoo Mini Plus, I've noticed some stuttering happening while playing Pokemon Unbound in Retroarch that started out of nowhere recently, and have slowly gotten more frequent.

You can see it in the video at the 0s, 6s, and 10s marks. Note the audio does not chop and doesn't stop playing. Does anyone have any ideas for fixing this?

I have tried toggling:

  • V-Sync
  • G-Sync
  • Threaded Video
  • Auto Frame Delay
  • Audio Sync
  • Edit: overclocked to 1800 as well

My device info is:

  • Miyoo Mini Plus, OnionOS
  • Retroarch 1.22.2
  • gpSP core v1.1.0-6250979

r/MiyooMini • • 1d ago

Lounge Tis the season

Post image
14 Upvotes

r/MiyooMini • • 7h ago

Help Needed! Help my Games are gone

0 Upvotes

I lost my SD Card from the miyoo Mini and now i want the Games Back how can i Download them all Back in my new Sd Card ?


r/MiyooMini • • 1d ago

Custom Firmware GPSP core with cable link emulator

Enable HLS to view with audio, or disable this notification

18 Upvotes

I bring you a modified version of GPSP with an extra connection option called cable link, tested in Koriki via AD-HOC network (it's slow on a normal network).

Finally, you can play Mario Kart on GBA in multiplayer mode!!

I haven't tested it on other systems, so I can't say what its effects are.

You can download the core here:

https://rparadise-team.github.io/Koriki/armhf/gpsp_plus_libretro.so.zip


r/MiyooMini • • 1d ago

Announcements CoGSDL: a ChoiceScript interpreter

8 Upvotes

Hi,

I made a ChoiceScript interpreter for the Miyoo Mini (Onion).
You can download the interpreter from https://github.com/sakya/CoGSDL
In the README there are information on how to install games.

Feedback is welcome!

EDIT: the screenshot are from the pc version. On the Miyoo Mini the fonts are bigger


r/MiyooMini • • 1d ago

Help Needed! my games stopped working

Enable HLS to view with audio, or disable this notification

3 Upvotes

this morning waiting for lessons to start i was playing on my miyoo mini plus , when the lessons started i turned it off and put it in my backpack UNTOUCHED until the end of class, i got home turned it on and it won’t open ANY game i have , i bought it 2 weeks ago without any sd included so i used a brand new one and im using onionOS


r/MiyooMini • • 1d ago

Flip Would a USB-C Bluetooth adapter work with the Miyoo Mini Flip?

3 Upvotes

Something like this for example. (https://a.co/d/0janq4Dg) I heard USB-C headphones won't work without the included dongle, but maybe something like this?


r/MiyooMini • • 2d ago

Game Testing/Settings Peak gaming right here

Post image
40 Upvotes

Absolute game changer!! 👌 Downloaded sunshine/moonlight and worked out all the kinks pretty much JUST to play pokerogue on the handheld 😭🤣 Technology never ceases to amaze me but WE NEED AN ACTUAL MIYOO PORT FOR POKEROGUE DAMMIT. Lol

Messed around with some steam games too and that was goofy fun, but terrible to control anything with double analog stick control as youd imagine 😂


r/MiyooMini • • 2d ago

Recommend a Game What JRPG next??

9 Upvotes

Hey all! I got my MM+ around 2 weeks ago, promptly starting my first playthrough of Chrono Trigger. I just beat it tonight, and am blown away! I’m looking to start another JRPG. Other notable JRPGs I’ve played and beaten are Mother 2 and 3, FF1, FF7, DQ1, DQ2, DQ3, and DQ4. I’m really trying to play more classic “must play” JRPGs (Yes, FF6 is on my list!). What game should I check out next?


r/MiyooMini • • 1d ago

Lounge Miyoo Mini Plus in 2026

Thumbnail
1 Upvotes

r/MiyooMini • • 2d ago

Game Testing/Settings Cable link gba?!

Post image
24 Upvotes

The power?! I am make test in gpsp core mods!!


r/MiyooMini • • 1d ago

Mini+ Miyoo Mini Plus case with extra pocket/space?

5 Upvotes

Anyone have any suggestions for a storage case where I can store some earbuds with the miyoo? The original is just a bit tight.

Im hoping for a separate pocket for earbuds, cable, sd adapter, etc. Nothing pretty, just something somewhat sturdy. I was looking at hard drive cases as a jumping off point.


r/MiyooMini • • 1d ago

Help Needed! Nothing loading on my MM+

3 Upvotes

As the title says, my MM+ with onionOS simply goes right back to the main menu when I try to open anything. Weird thing is, this came out of nowhere (I've been using the console for a couple of years now): I turned on the console as always but the "recent" tab on the main menu is gone, my favorites list is empty, and I can't even open an app. It goes to the loading screen, then back to the main menu. Any help is greatly appreciated. I'm running OnionOS 4.3.1-1 with a 128GB Sandisk SD card.


r/MiyooMini • • 1d ago

Help Needed! Buttons not responsive

1 Upvotes

Suddenly the following problems appeared while playing:
The battery shows 0% even though the battery is charged. When i start the device without sd card it shows full battery.
Also when i start the device the last game is playable, but the power button, volume buttons etc. are not responsive. The only way to turn off the device is by removing the battery.

Any ideas what might be the issue?


r/MiyooMini • • 3d ago

Themes MiyooMini OS for Kids

Enable HLS to view with audio, or disable this notification

494 Upvotes

I created a modified version of OnionOS for my kids.

It features a much simpler starting screen so they don't get lost, and a limited amount of coins for the arcade games.
You can try it at https://github.com/coorasse/onionKidsOS
Any feedback is welcome! And if you like it please star or watch the repo on GitHub for updates.


r/MiyooMini • • 2d ago

Mini+ Cherishing the time...

Post image
97 Upvotes

I remember how quiet and locked in we would be and how we laughed so hard watching each other panic after being spotted. Replaying this game has brought back some good memories of times with a cousin.


r/MiyooMini • • 2d ago

Help Needed! Should I name him the same as my dog?

Post image
30 Upvotes

Just booted up Mother 3 in my miyoo mini and was prompted to use a name for my dog, I need to know nothing happens to them ingame so i can name him the same as my pup


r/MiyooMini • • 2d ago

Flip Making some Cross-save scripts for games.

Post image
14 Upvotes

r/MiyooMini • • 3d ago

Ports UFO 50 on the Miyoo Mini

Post image
178 Upvotes

Patreon

GitHub

Port is free, patreon is optional. Huge thanks to Butterscotch.


r/MiyooMini • • 2d ago

OnionOS Help Newbie question

3 Upvotes

Hello, I’m totally new to emulation and retro devices, I’m trying to decide between a Miyoo Mini Plus and a Flip V2 for my first retro handheld but my main question is, how hard is it to install Onion OS for someone who’s completely new to emulation and knows absolutely nothing about it? Should I just get a device with Onion OS already installed or will that make it even more difficult since it means it won’t come with any games and I’ll have to download them myself (which I also don’t know how to do)

I appreciate any feedback and tips. Thanks