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

theme

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).

theme_fade_color

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.

theme_heading_color

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

theme_heading_color = #f68355

Overlay Image

theme_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

inhibit_aspect_correction

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