> For the complete documentation index, see [llms.txt](https://docs.monarchlinux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.monarchlinux.com/basics/themes.md).

# Themes

Choose Monarch colors, wallpapers, fonts, and login and boot appearance.

Monarch uses **Noctalia v5** for desktop colors and wallpapers. Open **Monarch Menu → Personalization** with **SUPER + ALT + Space**. **SUPER + CTRL + SHIFT + Space** opens the Personalization menu directly; it does not change the theme by itself.

![Monarch theme picker with the theme list and a preview of Matte Black.](https://2401007956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPHuQxvjCbX3wVSeqqOGO%2Fuploads%2FbmaxV9xy8dvZJgcryRRW%2Ftheme-picker.webp?alt=media)

*Preview a theme before applying it. The desktop theme and Unlock appearance are separate choices.*

## Choose colors and appearance

| Setting              | Where to find it                                                                           |
| -------------------- | ------------------------------------------------------------------------------------------ |
| Color theme          | **Personalization → Theme** previews and applies a palette.                                |
| Dark mode            | **Personalization → Dark Mode** switches Noctalia's appearance mode.                       |
| Wallpaper            | **Personalization → Backgrounds** shows images for the active theme.                       |
| Font                 | **Personalization → Font** changes the system monospace font.                              |
| Login and boot image | **Personalization → Unlock** previews and applies a matching SDDM and Plymouth appearance. |

Monarch's bundled palettes currently use the same colors in both light and dark mode. Noctalia applies enabled color templates to supported applications; an application may need to be reopened to show its new colors.

## Use your own wallpaper

Press **SUPER + CTRL + Space** to open the background picker, or choose **Personalization → Backgrounds**. Select an image to apply it. To add one, choose **Import** in the picker and select a JPG, PNG, GIF, BMP, or WebP file.

Imported images are copied to `~/.config/monarch/backgrounds/<theme>/` so they remain available with that theme. From a terminal, you can also run:

```bash
monarch theme background-import ~/Pictures/my-wallpaper.png
```

![Monarch background picker showing wallpaper thumbnails, a large preview and the Import button.](https://2401007956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPHuQxvjCbX3wVSeqqOGO%2Fuploads%2Fv8uyAI21rv0vFgvvYc6a%2Fwallpaper-picker.webp?alt=media)

*Preview and apply a wallpaper, or use Import to add your own image. The personal filename in this capture has been anonymized.*

## Fonts and additional themes

Choose **Personalization → Font** for an installed monospace font. Some applications need a restart before the new font appears. The terminal equivalents are:

```bash
monarch font list
monarch font set "CaskaydiaMono Nerd Font"
```

## Install, update and remove themes

**Software → Theme** installs a Monarch theme from a Git repository and applies it. Its palette is added to Noctalia; the desktop theme and the **Unlock** appearance remain separate choices.

From a terminal:

```bash
monarch theme install https://github.com/example/aurora-monarch-theme.git
monarch theme update
monarch theme remove
```

Replace the example URL with the repository of the theme you want to install. Theme bundles contain palette and image data, not scripts or application configuration.

Updates and removal are also available in the Monarch menu. Wallpapers you imported through Monarch are kept when a theme is updated or removed.

For manual Noctalia settings, see [Noctalia](https://docs.monarchlinux.com/basics/noctalia.md). Put your own overrides in a separate `~/.config/noctalia/*.toml` file so a Monarch refresh can update managed defaults.
