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