FS-UAE Theme Options

Shown on the right is a theme based on the very nice bezel created by the artist “Ambermoon” (you can download this theme here).

Starting with version 1.3.8, FS-UAE supports loading custom themes.

This page describes the options available for making custom themes. If you create a nice theme, consider making it available for download and post a link in the comment section to share it with others!

Using Themes


Since 1.3.8. Use this option to use a specific theme. The theme folder can be located either in share/fs-uae (a bundled theme), or in (My) Documents/FS-UAE/Themes.

theme = name_of_theme_folder

Theme Colors

Colors are specified like this: #rrggbbaa where each color component is a number from 0 to 255 (hex). You can omit alpha value, in which case the alpha is implicitly set to 255 (ff).


Since 1.3.8. The color the screen fades out to when exiting FS-UAE.

theme_fade_color = #3c3b37

Wall / Floor in Perspective Mode

Since 1.3.8. The top color of the wall gradient.

theme_wall_color_1 = #3c3b37

Since 1.3.8. The bottom color of the wall gradient.

theme_wall_color_2 = #3c3b37

Since 1.3.8. The top color of the floor gradient.

theme_floor_color_1 = #1d1d1b

Since 1.3.8. The bottom color of the floor gradient.

theme_floor_color_2 = #111110

Sidebar Menu Options

Most of the look of the sidebar comes from textures (see the contents share/fs-uae), and can be altered by overriding these images in the theme.


Since 1.3.8. The color of the heading items in the sidebar.

theme_heading_color = #f68355

Overlay Image


Since 1.3.8. This option allows you to specify the name of a png file which will be stretched (if necessary) and displayed on top of the screen. The image should have transparent areas (alpha channel), so the Amiga display will show through. You will also normally want to set scaling options (or other display options) to make the Amiga display output fit the overlay image.

theme_overlay_image = overlay.png

Other Overlay Images

Since 1.3.8. You can add overlay images to the theme which will be shown on some specific conditions:

  • custom_0 – will be displayed when df0 LED is active.
  • custom_1 – will be displayed when df1 LED is active.
  • custom_2 – will be displayed when df2 LED is active.
  • custom_3 – will be displayed when df3 LED is active.
  • custom_4 – will be displayed when a disk is inserted into df0
  • custom_5 – will be displayed when a disk is inserted into df1
  • custom_6 – will be displayed when a disk is inserted into df2
  • custom_7 – will be displayed when a disk is inserted into df3

The images themselves should be named custom0.png, custom1.png, etc. and put in the themes folder. You only have to provide images for the effects you want to show. The images can have any dimensions.

The position of the overlay images is specified like this:

theme_custom_0_x = 1605
theme_custom_0_y = 931

And similarly for the other custom images. Important note: the coordinates are relative to a 1920×1080 coordinate system with (0,0) in the top-left corner, even though your window may have another size. This means that the center of the window is always coordinate (640, 540).

Other Options


Since 1.3.8. With some themes with overlays and/or specific scaling options (or explicitly configured viewport), you may want to set the following option to disable the keep_aspect option.

inhibit_aspect_correction = 1


8 thoughts on “FS-UAE Theme Options

  1. hi guys,i’m new with themes and fs-uae,i can display ambermoon’s but on the sides of 1084 monitor there are two big black columns,like two massively thick lines,covering the book and the post-its,i wish i could upload a pic:(

  2. Hello!

    Does this “default” theme have blinking leds/etc? I’ve installed it, but it’s static here.

    If not, are there others available elsewhere? I tried to find, but no luck.

    • Hi, no, this theme does not have blinking leds. The author of the theme did not want me to distribute a version of the theme with blinking leds. You should be able to create a custom theme with overlay images for floppy leds using the information here: http://fs-uae.net/theme-options.

  3. Pingback: FS-UAE: Emulador de Amiga | Cógeme la matrícula

  4. i like the theme from ambermoon, but it seems to be incomplete. are the images for inserted disk and led missing? or is it just the background?

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.