By default, the buttons for genres/categories on the main screen in the Classic and Modern UI layouts have different colored backgrounds. If you want, you can override these with images of your own, on a per-system basis. The images should have an aspect ratio of 4:3 and be at least 400×300 pixels in size (preferably 800×600 if it should look crisp in 4k).

The default grid view image (visible in Classic mode only) can also be overridden on a per-system basis. The image can have any aspect ratio, but will be scaled to a maximum of 350×350 pixels on a 1080p screen (700×700 pixels on a 4k screen). The default image is 400×300 pixels.

Game artwork is automatically downloaded where available when scraping (depending on your settings). If you want to override this (maybe you don’t like the downloaded images, or no images are automatically available) you can use your own custom media.

You can also add game videos this way!

Where to place your custom media depends on the "Custom media location" setting in Global UI Settings, for maximum flexibility. All the available options are listed below. Please note that custom media for the Android systems should always be placed in the Theme directory (because Android doesn't have a rom directory of its own). Also, background videos are currently only supported in Arcade.

• [romdir] should be replaced by the configured rom directory for the given system.
• [romname] should be replaced by the rom filename without extension (e.g. for "Awesome Game.smc", [romname] should be "Awesome Game").
• [themedir] should be replaced by the configured theme directory.
• [systemname] should be replaced by the name of the given system.
• [genrename] should be replaced by the exact lowercase name of the genre (e.g. for "Action", [genrename] should be "action"). For the All Games genre, the name should be "all".

ROM directory, in subdirectories

• Game box: [romdir]/media/box/[romname].png
• Game box back: [romdir]/media/boxback/[romname].png
• Game box 3d: [romdir]/media/box3d/[romname].png
• Game cart: [romdir]/media/cart/[romname].png
• Game cart 3d: [romdir]/media/cart3d/[romname].png
• Game disc: [romdir]/media/disc/[romname].png
• Game clearlogo: [romdir]/media/clearlogo/[romname].png
• Game banner: [romdir]/media/banner/[romname].png
• Game advert flyer: [romdir]/media/advert/[romname].png
• Game background: [romdir]/media/background/[romname].png
• Game video: [romdir]/media/video/[romname].mp4
• Game manual: [romdir]/media/manual/[romname].pdf
• Genres: [romdir]/media/genres/[genrename].png
• Grid view: [romdir]/media/grid_view.png
• System background: [romdir]/media/background.png
• System background for the Arcade game selection screen: [romdir]/media/background_arcade_game_select.png
• System background video: [romdir]/media/background.mp4
• System clearlogo: [romdir]/media/clearlogo.png
• System clearlogo (selected): [romdir]/media/clearlogo_selected.png
• System loading screen: [romdir]/media/loadingscreen.mp4 or [romdir]/media/loadingscreen.png

ROM directory, everything in the same directory

• Game box: [romdir]/[romname]_box.png
• Game box back: [romdir]/[romname]_boxback.png
• Game box 3d: [romdir]/[romname]_box3d.png
• Game cart: [romdir]/[romname]_cart.png
• Game cart 3d: [romdir]/[romname]_cart3d.png
• Game disc: [romdir]/[romname]_disc.png
• Game clearlogo: [romdir]/[romname]_clearlogo.png
• Game banner: [romdir]/[romname]_banner.png
• Game advert flyer: [romdir]/[romname]_advert.png
• Game background: [romdir]/[romname]_background.png
• Game video: [romdir]/[romname].mp4
• Game manual: [romdir]/[romname]_manual.pdf
• Genres: [romdir]/genre_[genrename].png
• Grid view: [romdir]/grid_view.png
• System background: [romdir]/background.png
• System background for the Arcade game selection screen: [romdir]/background_arcade_game_select.png
• System background video: [romdir]/background.mp4
• System clearlogo: [romdir]/clearlogo.png
• System clearlogo (selected): [romdir]/clearlogo_selected.png
• System loading screen: [romdir]/loadingscreen.mp4 or [romdir]/loadingscreen.png

Theme directory, in subdirectories

• Game box: [themedir]/[systemname]/media/box/[romname].png
• Game box back: [themedir]/[systemname]/media/boxback/[romname].png
• Game box 3d: [themedir]/[systemname]/media/box3d/[romname].png
• Game cart: [themedir]/[systemname]/media/cart/[romname].png
• Game cart 3d: [themedir]/[systemname]/media/cart3d/[romname].png
• Game disc: [themedir]/[systemname]/media/disc/[romname].png
• Game clearlogo: [themedir]/[systemname]/media/clearlogo/[romname].png
• Game banner: [themedir]/[systemname]/media/banner/[romname].png
• Game advert flyer: [themedir]/[systemname]/media/advert/[romname].png
• Game background: [themedir]/[systemname]/media/background/[romname].png
• Game video: [themedir]/[systemname]/media/video/[romname].mp4
• Game manual: [themedir]/[systemname]/media/manual/[romname].pdf
• Genres: [themedir]/[systemname]/media/genres/[genrename].png
• Grid view: [themedir]/[systemname]/media/grid_view.png
• System background: [themedir]/[systemname]/media/background.png
• System background for the Arcade game selection screen: [themedir]/[systemname]/media/background_arcade_game_select.png
• System background video: [themedir]/[systemname]/media/background.mp4
• System clearlogo: [themedir]/[systemname]/media/clearlogo.png
• System clearlogo (selected): [themedir]/[systemname]/media/clearlogo_selected.png
• System loading screen: [themedir]/[systemname]/media/loadingscreen.mp4 or [themedir]/[systemname]/media/loadingscreen.png

Theme directory, everything in the same directory (one per system)

• Game box: [themedir]/[systemname]/[romname]_box.png
• Game box back: [themedir]/[systemname]/[romname]_boxback.png
• Game box 3d: [themedir]/[systemname]/[romname]_box3d.png
• Game cart: [themedir]/[systemname]/[romname]_cart.png
• Game cart 3d: [themedir]/[systemname]/[romname]_cart3d.png
• Game disc: [themedir]/[systemname]/[romname]_disc.png
• Game clearlogo: [themedir]/[systemname]/[romname]_clearlogo.png
• Game banner: [themedir]/[systemname]/[romname]_banner.png
• Game advert flyer: [themedir]/[systemname]/[romname]_advert.png
• Game background: [themedir]/[systemname]/[romname]_background.png
• Game video: [themedir]/[systemname]/[romname].mp4
• Game manual: [themedir]/[systemname]/[romname]_manual.pdf
• Genres: [themedir]/[systemname]/genre_[genrename].png
• Grid view: [themedir]/[systemname]/grid_view.png
• System background: [themedir]/[systemname]/background.png
• System background for the Arcade game selection screen: [themedir]/[systemname]/background_arcade_game_select.png
• System background video: [themedir]/[systemname]/background.mp4
• System clearlogo: [themedir]/[systemname]/clearlogo.png
• System clearlogo (selected): [themedir]/[systemname]/clearlogo_selected.png
• System loading screen: [themedir]/[systemname]/loadingscreen.mp4 or [themedir]/[systemname]/loadingscreen.png

You can have multiple backgrounds, flyers, videos and manuals for the same game by adding more files with "_#" to the end of the filename. For example, if you have "game.png" in your background directory, you can add "game_2.png" for a second background, "game_3.png" for a third, and so on. It works the same way for advert flyers, videos and manuals.

In addition to all of the above, you can also further change the look and feel of the app with a theme. See Themes for more information.