Box Art problem, but preview image shown

I am new to MUOS and am trying to show box art in the cataloge view. I installed the images and the “preview” image is shown when i press the menu button for the info menu on a game and then A for preview. But it does not show the art when I am in the list view.

What am I doing wrong?

Thanks. I found that and applied the file. But sadly it does not fix the issue for me.

Maybe there is something I don’t understand? Is there something I have to set to show the art next to the names of the titles? Do I need to install a specific theme?

As I said, the preview image is shown in the "additional info” dialog that I can open when pressing the menu button. So it looks like the folder is found and assigned correctly?

different themes can have any impact as they can affect positioning of the box art. they may expect the artwork to be a certain size.

there are also menu options that affect whether box art is displayed
Configuration -> Customisation -> Content Box Art
Configuration -> Customisation -> Content Box Art Alignment

it’s a good idea to try it with the default theme. if it works there and not with a different theme, let us know the theme.

also since you said previews are working you should have art in
/muos/info/catalogue/{System}/preview

check the box art is in

/muos/info/catalogue/{System}/box

The box art is in the /box folder, has the same name as the working preview art, and it is a 240x240 png that was generated by Artie (that is the last one I tried, I tried a couple of artwork downloader/generators).

I am using the “MustardOS” theme and tried several of the Content Box Art and Content Box Art Alignment settings.

Is there a logfile that i can open and check for error messages?

no there is not a log file. typically when people cannot see box art it boils down to:

  1. Core is not assigned to the the directory: Assigning a Core to a directory

  2. Art is not copied to the correct folder:
    Artwork | MustardOS
    this also includes times when a user copies their artwork to SD1 but catalogue exists on SD2 so it really is pulling from there

  3. The name does not exactly match. We’ve had users that were on Windows and file extensions were hidden so they did not realize that it was not named correctly.

  4. not a valid png file. Try opening the image on another device. or since you said previews are working try copying it to the preview folder and see if it can load it. Or try viewing the image in Dingux Commander under applications.

Okay, I played around with this and found something weird.

If I put the box art in `/muos/info/catalogue/{System}` , one level up to where it is supposed to be, it works?

my guess is you never really applied the box art patch in the first place.

box art only loads from the ‘box’ folder so if you’re seeing otherwise I’d probably re-apply that patch

Tried it again now. I installed the MustardOS_2508.2_Patch_377d3471.muxupd and the BoxArt patch MustardOS_2508.2_Boxart_Fix.muxup after that. But the behavior stays the same.

System Details says muOS Version 2508.2 Silly Goose (377d3471)

I don’t know what to tell you the patch just works.

I downgraded my device to MustardOS_2508.2_Patch_377d3471.muxupd and verified my box art that is in the box folder is not being displayed.

I then installed MustardOS_2508.2_Boxart_Fix.muxupd and verified my box art that is in the box folder is now displaying fine.

neither version would load box art from the root of the system folder so don’t know what you’re talking about there.

Maybe you can provide example of the full image file paths. for example:

/MUOS/info/catalogue/NEC PC Engine/box/Bomberman '93 (USA).png

Note: Several users have already installed the patch and confirmed it’s if functioning

Hi, there was always a struggle with gofile. can you please provide the fix in a different link like Mega or Google, etc..

it’s pinned in muOS discord general chat if you have access to that

it was on the mega link too already

1 Like

I am not saying that the patch is not working. And sorry if you read my message as an attack. I always assume I am holding things wrong. Hence the questions here. Maybe there is still a weird bug, but in most cases like this, it’s an user error. And i really just want to figure out the exact error here.

So what I have is a file that works as box art when its here:

/mnt/sdcard/MUOS/info/catalogue/Atari Lynx/Blue Lightning.png

and not when it’s here:

/mnt/sdcard/MUOS/info/catalogue/Atari Lynx/box/Blue Lightning.png

There is also a catalogue folder on /mnt/mmc, but I used the transfer function earlier to move everything to SD2. Is that leftover causing some problems? Should/can I delete it?

on boot if /mnt/sdcard/MUOS/info/catalogue/ exists that is where it will look for artwork if not it would fall back to the first SD card. If you do a terminal session through SSH you would be able to see output of where it loaded the image file from. The message would look like:

[437.82]        [2025-10-15 13:56:20] [*] [muxplore]    Reading Configuration: /opt/muos/share/info/core/PCE/core.cfg
[437.82]        [2025-10-15 13:56:20] [*] [muxplore]    Loading 'box' Artwork: /run/muos/storage/info/catalogue/NEC PC Engine/box/Bomberman '94 (Japan).png

but /run/muos/storage/info/catalogue/ is a bind mount that points to the SD2 or SD1 path.

to connect with a terminal you would need to enable Secure Shell under Web Services then connect with your SSH client to root@{IPAdress}:22, password is root

then you would have to issue a command to kill everything running
killall -9 muxfrontend frontend.sh

then a command to start things
/opt/muos/script/mux/frontend.sh

then you should see the output

Okay, this is weird.

The log says:

[4633.69]       [2025-10-15 21:06:57] [*] [muxplore]    Reading Configuration: /opt/muos/share/info/core/LYNX/core.cfg
[4633.69]       [2025-10-15 21:06:57] [*] [muxplore]    Loading 'box' Artwork: /run/muos/storage/info/catalogue/Atari Lynx/box/Shadow of the Beast.png

Which looks correct, but it does not show the image unless it is in

/run/muos/storage/info/catalogue/Atari Lynx/Shadow of the Beast.png

I just tried. I deleted the file in the parent folder of the box one, moved the cursor, it did not show the file, copied it to the wrong place again and moved the cursor. And then it showed it.

If it helps, the core.cfg looks like this:

handy_libretro.so
Atari Lynx
Atari Lynx
0

don’t know what to tell you, it’s hard coded in code to look in the box directory and according to console output that is where it found it.

maybe something with how you are transferring the files or you just have defective SD card. You could try shutting down and then booting up with just 1 SD card.

I found the way Artie works to be weird; you scrape your artwork, then create a catalogue file you then have to “extract” (at least that’s how it worked for me). Maybe you would have better luck using Scrappy, which will install the artwork in the correct location directly.

Many thanks, really appreciate it.