muOS Quick Start Guide

FAQ User Insights
,
1

image
image320×320 30 KB

Getting Started With muOS

I’ve put together an abbreviated guide/FAQ with multiple sources for people who want to get started.

General Sources

https://community.muos.dev - Community Forum (Here)
https://muos.dev - Main Website
MustardOS - Discord

Is my device supported? (As of 6/12/25)

Not Supported:

  • RG35XX

Public Release:

  • RG28XX
  • RG35XX+/2024/SP/H
  • RG34XXH
  • RG40XXH/V
  • RGCubeXX

Test Release:
These devices may not have full functionality yet

  • TrimUI Smart Pro
  • TrimUI Brick

Planned:

  • RG34XXSP
  • MagicX Zero28

My favorite YouTube channel showed off the RG34XXSP using muOS, where do I get it?

It’s unofficial. What most YouTube videos are showing is the RG34XXH image on the RG34XXSP since they have very similar hardware.

There is also an unofficial 34XXSP Pixie image floating around. While the image created by 0xAda.3 is 99% Pixie; 1% is still unofficial and may or may not work on your device.

How do I get access to a test image?

You should support muOS if you want to support muOS, not because you want one of the test releases. But if you really want it anyways, look into supporting muOS.

How can I tell what version of the RG35XX “Plus” that I have?

Model: Sticker

  • RG35XX+: RG35XX Plus
  • RG35XX 2024: RG35XX+

Getting Started

I’m upgrading to Pixie from an older version

Installation Guide/Download Sources

General Device Hotkeys

Where did the Migrate to SD2 script go?

What type of SD card should I get?

28XX/35XX 2024 WiFi

You will want to buy a WiFi adapter with a compatible 8188eu chipset and then download the WiFi install archive off the device page for your device. The install archives will be zip format; rename them to have a muxupd extension.

How do I add content to my device?

What are some applications I can add to my device?

  • Portmaster: Comes pre-installed on muOS. You can filter what games/applications you can install via the “Games” section on their website.
  • Scrappy - An application based off Skyscraper that can use screenscraper.fr and templates.
  • Bluetooth - A Bluetooth frontend application for the system backend service that allows general use with Bluetooth keyboards, controllers and audio devices.
  • SFTPGo - This is a web server on your device you can enable to access your device remotely.
  • Syncthing - This is an open-source file sharing service you can self-host for free on your network.
  • Activity Tracker
  • There are more applications pre-installed under Applications/Utilities and the Web Services menu in your device.
  • More applications are listed in the Applications section in the forum.

How do I add themes?

Per Device Resolutions:

  • 640x480: RG28XX, RG35XX(+/2024/H/SP), RG40XX(H/V)
  • 720x480: RG34XX
  • 720x720: RGCubeXX
  • 1024x768: TrimUI Brick
  • 1280x720: TrimUI Smart Pro

HDMI Output Resolutions:

  • 720x480: 480p
  • 720x576: 576p
  • 1280x720: 720p

You can download them from a few different sources:

Can I download ALL of the themes?

The theme I want doesn’t have the resolution my device uses/doesn’t support HDMI.

This is alright, the theme engine will try to fit the theme the best it can using what’s available. You may get black bars/letterboxing if the aspect ratio doesn’t match your device.

The theme I want isn’t a muxthm file and the system doesn’t recognize it…

As of Pixie, themes are only supported as muxthm archives, older themes won’t work. You can try getting in touch with the theme author, but there is nothing we can do about this.

How do I add boxart?

How do I add system images in Content Explorer?

Some themes support something called Grid Mode. In Grid Mode you can add art to display for your systems.

Where can I find Grid Mode images?

My boxart is hiding my game titles/the game title isn’t showing completely

Retroarch

This is a topic entirely deserving of its own guide, here’s one created by RetroGameCorps. Additionally, here are some topics that you may encounter while using muOS.

Getting Started (With Retroarch)

While much of Retroarch is already set with the optimal settings for muOS and your device, you may want to change things. If you aren’t already familiar with Retroarch, it may pay off to get familiar with the software in general.

For those not familiar, a decent number of systems are covered by libretro “cores”, these are emulator libraries that hook into the Retroarch frontend.

Here are some topics that can apply directly to muOS:

Retroarch Cheats

Retroarch has cheat support for games it recognizes the hash of. In Archive Manager, there should be a Retroarch Cheat archive you can install; this is a copy of the same cheats database found here. You can also add cheats to Retroarch if you have them offhand.

Retroarch Menu Interface

The user interface used by muOS (and a lot of other CFWs) is RGUI.
This can be changed, but may have a performance impact:

Retroarch Troubleshooting and Optimization

There’s also some excellent wiki articles in the libretro documentation on optimization and deeper settings in Retroarch:

Retro Achievements

You can setup RetroAchievements through the normal process in Retroarch. You need to do the following:

  • Start Retroarch through the Applications menu
  • Navigate to the achievements options and enter your account information
  • Save your general Retroarch config.

Refer to the libretro documentation for core compatibility with achievements.

Troubleshooting/Common Questions

My device won’t boot!

I recommend you visit the forum issues section and the Discord. The dev team is aware of the issue, but sometimes we can’t help you.

GBA runs poorly on my device.

In Pixie the default core for GBA was switched to mGBA.
Try these in order:

PSP runs poorly on my device.

N64/Dreamcast/PSP/DS still runs poorly on my device.

I can’t manage my files from the Content Explorer.

I can’t launch my game/port.

HDMI Console Mode™ isn’t working.

The lid on my SP doesn’t work.

Windows can’t see my SD card.

I messed something up…

No, I messed up PPSSPP by changing it to use Vulkan.

No, I REALLY messed up PPSSPP.

A restore script is being added in a future version. In the meantime, you can restore the control.ini and ppsspp.ini files. They will be at .../MUOS/emulator/ppsspp/.config/ppsspp/PSP/SYSTEM.

No, it was working and now my device is acting weird.

Things might even improve in a later muOS version, we’ve been hard at work to try to work out the bugs/introduce new bugs :person_shrugging:

Miscellaneous Odds and Ends

I have a cool idea!

Neat! Submit it here: Ideas - MustardOS Community Forum

I just want to tell you guys how awesome you are!

Also neat! You can find us lurking around the Discord and Forum.

There’s something not covered in this guide, I have a complaint
It’s tough to include everything ever asked about muOS in one document, but you can catch me on Discord or the Forum :melting_face:

I should also mention there is a helpful information post I pull as source material as well. Feel free to do your own writeup of a topic, drop a useful hint, or even write your own FAQ here.

Lastly, if nothing else works politely try putting in a post in the issues section or ask a question on the Discord! There are plenty of helpful people who may have an answer to your question.

6 Likes