Using Themes

Server Box includes the Default and AMOLED themes and lets you install more, such as One Dark Pro, from the theme store or from a theme file. Theme settings are under Settings → Appearance. The Monitor panel installs the same theme packages; see In the Monitor panel.

Choose a theme

Open Theme preset to choose a built-in theme, an installed theme, or Custom. Moving through the list previews themes without saving the change. Select a theme to apply it. Dismiss the picker to keep the theme you had before opening it.

Some theme packages contain several variants, such as the Trans, Nonbinary and Rainbow variants of Pride. Each variant is listed separately, as Pride · Trans, and can be chosen like any other theme. The package is installed and updated once for all of its variants.

Custom lets you choose a local background image and adjust app icons, corner radii, opacity, and blur. These options are separate from the read-only values in a packaged theme.

Themes declare which appearance modes they support. Themes that support both Light and Dark can be used with System, Light, or Dark. If a theme supports only one mode, the mode setting is locked while that theme is selected. Choose a theme that supports both modes to switch freely.

AMOLED is a built-in theme. It uses black surfaces in Dark mode and standard light colors in Light mode.

Install a theme

Open Settings → Appearance → Install theme. Choose one of these sources:

• File to select a .fsbt theme package.
• URL to install a theme package from an HTTPS link.
• Folder on desktop to import a theme directory, useful while developing a theme.

After installation, the theme is applied and appears in Theme preset. Installing a theme that is already installed, such as a newer version or a theme folder imported again after editing, replaces the earlier installation; if that theme was in use, the new one stays selected. Other installed themes are not affected.

Browse the theme store

Open Settings → Appearance → Theme store to browse themes from the theme catalog. A catalog theme that is already installed is shown in the same row. Select an uninstalled theme to download and apply it. Select an installed theme to apply it. Use the button beside a theme to install or remove it, depending on its current state. Removing the theme in use returns the app to its default theme.

Use the expand button on a row to preview the theme before installing it. The preview uses the theme’s colors, component styles, background and icons; segmented controls above it switch between Light and Dark and between the package’s variants. A theme that is not installed is downloaded for the preview and checked like an install; nothing is installed or applied. Previews are closed by default, and downloaded preview files are deleted when the store is closed.

For an installed package with variants, the row shows a segmented control with one segment per variant; select a segment to apply that variant.

The store remembers its latest results between launches, so previously loaded themes remain visible while offline. The caption below the app bar shows when the list was last updated; each catalog theme’s row shows its repository and version. Use the refresh button in the app bar or pull down on the list to check for updates. Descriptions are shown in the app’s language when the theme provides one. Search matches theme names, variant names, descriptions in any language, and repository names; the sort control can put the active theme first or sort by name.

When the store offers a different version of an installed theme, its row shows an update button. Updating replaces the installed version; if the theme is in use, it stays in use.

Some themes may require a newer app version. They remain visible in the store, with an explanation when they cannot be installed.

In the Monitor panel

The Monitor’s web panel uses the same .fsbt packages as the App. Themes in the panel are kept on the Monitor for your account, so they apply in every browser you sign in from, and they are separate from the themes installed in the App.

Open Settings → Appearance → Themes in the panel:

• Select Default for the desk’s own colors, or select an installed theme. A package with variants lists each one, such as Pride · Trans.
• Install a theme → From file uploads a .fsbt package. The Monitor reads and checks it with the same code as the App, and refuses a package that fails the checks.
• Theme store lists the themes of the ServerBox catalog. The Monitor downloads the package over HTTPS and checks its SHA-256 before installing it; the panel cannot make the Monitor download from any other address. A theme that needs a newer Monitor is shown but cannot be installed. A newer version of an installed theme shows Update.
• The delete button beside a theme removes it. Removing the theme in use returns the desk to Default.

A theme that supports only Dark or only Light sets the panel’s appearance mode while it is selected; a theme that supports both switches to its preferred mode when selected. Selecting a theme with a background image makes that image the desk’s wallpaper; the wallpaper choices on the same page can replace it. Each account can install at most 32 themes, using at most 128 MiB in total.

Create a theme

Theme packages are authored as a directory with a manifest.toml and optional images, then shared as a .fsbt file or published in a theme repository. See the theme authoring guide for the package format and publishing instructions.