Menu
Genre/category images
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).
Grid view image
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 media
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!
Custom media location
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 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
  • 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 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 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
  • 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 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 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
  • 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 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 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
  • 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 loading screen: [themedir]/[systemname]/loadingscreen.mp4 or [themedir]/[systemname]/loadingscreen.png
Multiple backgrounds, flyers and videos
You can have multiple backgrounds, flyers and videos 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 and videos.
Themes
Apart from all of the above, you can also further change the look and feel of the app with a theme. See Themes for more information.