muOS Artwork
Changes since muOS Origin v10
Box Art / Preview Art / Game Text is no longer tied to the directory structure you use for your ROMs.
All of these files are now stored in a location referred to as the catalogue.
muOS Catalogue Structure
Folders for all available systems should be automatically created for you.
These systems match the catalogue=
entry in /mnt/mmc/MUOS/info/assign/<system>.ini
Example ini file
[global]
name=Atari 2600
default=Stella
catalogue=Atari 2600
cache=0
Here we can see the catalogue folder for this system is Atari 2600
.
All game artwork should be named to match your ROMs.
SD1
└─ MUOS
└── info
└── catalogue
├── <System>
│ ├── box
│ │ └── romname.png
│ ├── preview
│ │ └── romname.png
│ └── text
│ └── romname.txt
├── Folder
│ ├── box
│ │ └── foldername.png
│ ├── preview
│ │ └── foldername.png
│ └── text
│ └── foldername.txt
└── Root
└── box
├── sd1.png
└── sd2.png
As muOS assigns artwork by system, you will need to assign a core before artwork is displayed.
Starting in muOS Beans
it should attempt to assign a system automatically.
Example
If you have some ROMs in:
/mnt/sdcard/roms/Nintendo/SNES/Action/*.zip
Artwork files for this system go in:
/mnt/mmc/MUOS/info/catalogue/Nintendo SNES-SFC/
The folder named Folder can be used to apply artwork to any folder in content explorer and just needs to match the folder name.
(not case sensitive). To have folder icons for all subdirectories listed, you would need:
catalogue
└── Folder
└── box
├── nintendo.png
├── snes.png
└── action.png
Theme overrides for Artwork
The max width for the text of an item in content explorer is controlled by the theme. This can result in scenarios where the item text is partially covered by the boxart.
You can override this behaviour so regardless of what theme you have installed the text will stop at a defined length. In /theme/override
you will find 3 files muxfavourite.txt
, muxhistory.txt
, and muxplore.txt
.
If you want to adjust just where the text auto ellipses you can set a value for FONT_LIST_PAD_RIGHT. Example:
[font]
FONT_LIST_PAD_RIGHT=280
[misc]
CONTENT_WIDTH=-1
If you also want the background bar of the item to resize you would instead adjust CONTENT_WIDTH. Example:
[font]
FONT_LIST_PAD_RIGHT=10
[misc]
CONTENT_WIDTH=360
antiKk’s muOS Artwork
Skraper mixes, and Artwork for the Tiny Best Set are available here:
https://github.com/antiKk/muOS-Artwork