SMS DOCS

Themes & Skins

SMS ships with a finished look out of the box β€” a full-screen desktop background, a set of device and file icons, and a boot splash β€” but the desktop background is skinnable. This page explains the desktop skin (a .smi background image), where SMS looks for it, and what this fork's refreshed artwork adds.

β„Ή You don't need a skin to use SMS
Skinning is entirely optional. On a fresh install SMS shows its built-in desktop and icons, and everything works. A skin only replaces the appearance β€” it never changes which devices or formats SMS supports. If you never touch the skin settings, you simply keep the default look.

The skin engine

SMS has always had a lightweight skin engine. The one thing it lets you replace is the desktop background, by pointing SMS at a .smi skin file:

FileExtensionWhat it changes
Desktop skin.smiThe full-screen background behind the device menu, file browser and status line β€” the "wallpaper".

A .smi is an IPU-encoded image β€” a compact picture format the PlayStation 2's IPU hardware decodes directly, the same colour pipeline SMS uses to draw video. When a desktop skin is set and loads successfully, its picture is stretched to fill the screen and replaces the default background; if no skin is set (or a skin file fails to load), SMS falls back to its built-in desktop.

β„Ή A note on .mbf files
Alongside the skin setting you may see a separate .mbf option. Despite living near the skin settings, .mbf is not a background image β€” it is an optional custom font used to draw text, most useful for subtitle scripts that need characters the built-in font doesn't cover. It changes how text looks, not the wallpaper. Subtitle rendering is covered on the Subtitles page.
β„Ή Where skins are chosen
The desktop skin name is an ordinary SMS setting. You pick it from the on-screen menus alongside the other player options, and β€” like every other setting β€” it is written to your saved configuration so it persists across reboots. See Settings Reference for how the settings menu is laid out and how configuration is saved.

This fork's look

This build ships with a refreshed desktop and a full set of device icons on top of the classic skin engine. Nothing about the engine changed β€” the new artwork is simply the default look you see before you apply any custom skin. Compared with older SMS builds you get:

These are baked into the program itself, so they are the same on every device you boot from. Applying a custom .smi skin overrides the desktop background on top of them; the icons stay as the built-in set.

Applying a skin

SMS looks for skin files in a Skins folder, and the location depends on how SMS was started:

Booted with a memory card

SMS looks on the memory card, under mc0:/SMS/Skins/. A desktop skin named MyTheme is loaded from mc0:/SMS/Skins/MyTheme.smi.

Booted from another device (this fork)

If SMS was launched from USB, HDD or another device and reads its settings there, it also looks for skins in a Skins folder next to the SMS program on that boot device β€” so a memory-card-less setup can still carry its own skins. This matches the way this fork saves configuration to the boot device. See Settings Reference.

Select the skin, then save

Put the .smi file in the appropriate Skins folder, choose it from the on-screen menu, and save your settings so it is remembered. On the next redraw the desktop background changes to your skin.

⚠ If a skin doesn't appear
Make sure the file has the exact .smi extension and sits directly in the Skins folder SMS is looking in (memory card or boot device, per above), and that the name you selected matches the file name. If a skin file can't be read or isn't a valid IPU image, SMS quietly falls back to its built-in desktop rather than showing an error β€” so a missing background usually means a wrong path, name or file format.

Making a skin

Because .smi is an IPU-encoded image and not a plain PNG or JPEG, you don't just rename a picture β€” the image has to be converted into the IPU format with a converter tool first. The workflow, conceptually, is:

Start from a full-screen image

Design your wallpaper at a normal screen resolution. SMS stretches the skin to fill the display, so a 4:3 image sized for standard-definition output gives the most predictable result.

Convert it to .smi

Run the image through an IPU converter to produce the .smi file. This is the step that turns an ordinary picture into something SMS's IPU decoder can load.

Drop it in Skins and select it

Copy the finished .smi into the Skins folder as in Applying a skin, pick it on-screen, and save.

Why isn't a skin just a PNG or JPEG?

The desktop skin loads through the PS2's IPU hardware, which decodes a specific image format rather than PNG/JPEG. Converting your picture to .smi up front means SMS can load and display the background quickly using the same hardware path it uses for video, without doing a general-purpose image decode every time it draws the desktop. The device and file icons in this fork are handled by a separate artwork pipeline and are built into the program, so they aren't part of the .smi skin.

Device icons

Every storage source in SMS has its own icon in the top device menu, so you can tell at a glance which device is selected. This fork ships a distinct icon for each:

DeviceIcon shows
USBUSB mass-storage drive
MX4SIO (microSD)A dedicated microSD icon β€” new in this fork; older builds reused another device's icon
Internal HDDHard-disk drive
i.LINKi.LINK / IEEE 1394 storage
MMCE (SD2PSX / MemCard PRO2)Memory-card-slot storage device
SMB network shareNetwork share
CD / DVDOptical disc β€” data CD or DVD
Audio CD (CDDA)Audio disc

The disc icon reflects the kind of disc in the drive β€” a data CD, a DVD and an audio CD are shown differently β€” so the device menu stays informative even when the same optical drive holds different media. See Devices Overview for how the device menu itself works.

Known issue: HD video modes and the background

⚠ High-definition output can currently corrupt the desktop background
On progressive / high-definition video output modes (for example 480p, 720p and 1080i), the full-screen desktop background can currently show graphical corruption. This is a known issue with the large HD framebuffer and is being worked on. Standard-definition 480i output is unaffected β€” if you see a corrupted background at an HD mode, switch the display mode back to 480i as a workaround while a fix is in progress.

This only affects how the background looks at HD modes β€” playback, browsing and all device access continue to work normally. If you don't run SMS at 720p/1080i you will never see it.

See also