Skip to content

LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.

Document the wallpapers: brand section, CHANGELOG 0.8.2, screenshots

Federico Pereira750a645e6619
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d5e2d3d..7285e7f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,26 @@ of the matching [GitHub release](https://github.com/lordbasex/LordOS/releases),
## [Unreleased]
+## [0.8.2] - Unreleased
+
+### Added
+
+- **New wallpapers.** Eleven original LordOS wallpapers in three categories: **Signature** (Crystal
+ Crown, Eternal Dawn, Royal Flow, Royal Waves, Violet Horizon), **Lumo** (Celestial, Aurora) and
+ **Cosmos** (Event Horizon, Infinite Galaxy, Solar Odyssey, Stellar Voyage), created by iPERFEX
+ with an AI image generator. Settings → Wallpaper now lists every wallpaper grouped by category,
+ with the previous four gradients as "Gradients". They are installed once in
+ `/usr/share/backgrounds/lordos/` as high-quality JPEG (about 4 MB in total) with small thumbnails
+ for the pickers, and a higher-resolution version added later is used automatically on the
+ screens that need it.
+
+### Changed
+
+- **New default wallpaper:** new users start on **Celestial**; anyone who already chose a wallpaper
+ keeps it. The login screen (and the remote login page) now shows **Crystal Crown**.
+- The Control Center shows the current wallpaper and three from the collection; the rest are in
+ Settings → Wallpaper (**Change Wallpaper…**).
+
## [0.8.1-beta] - 2026-10-19
A maintenance and polish release on top of 0.8.0-beta, and the first one that installed systems
diff --git a/docs/LORDOS-BRAND.md b/docs/LORDOS-BRAND.md
index 719b443..9290006 100644
--- a/docs/LORDOS-BRAND.md
+++ b/docs/LORDOS-BRAND.md
@@ -243,3 +243,45 @@ in outcome states, never in "nothing selected" panes.
- Don't give Lumo a long snout, a long tail or a big body; don't make it look like another
project's mascot.
- Don't trace or rebuild Lumo from raster images or screenshots.
+
+## 7. Wallpapers
+
+Created by iPERFEX with an AI image generator; part of the LordOS brand assets.
+© iPERFEX, part of the LordOS brand.
+
+Eleven original wallpapers in three categories, shipped in `/usr/share/backgrounds/lordos/` and
+listed by category in **Settings → Wallpaper** (with the default theme's four gradients as a fourth
+category, "Gradients"). The files, sizes and how to regenerate them are in
+[`assets/wallpapers/README.md`](../assets/wallpapers/README.md).
+
+| | Signature | |
+|:-:|:-:|:-:|
+| ![Crystal Crown](../assets/wallpapers/thumbs/signature/lordos-crystal-crown.jpg)<br>**Crystal Crown** (login screen) | ![Eternal Dawn](../assets/wallpapers/thumbs/signature/lordos-eternal-dawn.jpg)<br>**Eternal Dawn** | ![Royal Flow](../assets/wallpapers/thumbs/signature/lordos-royal-flow.jpg)<br>**Royal Flow** |
+| ![Royal Waves](../assets/wallpapers/thumbs/signature/lordos-royal-waves.jpg)<br>**Royal Waves** | ![Violet Horizon](../assets/wallpapers/thumbs/signature/lordos-violet-horizon.jpg)<br>**Violet Horizon** | |
+
+| Lumo | |
+|:-:|:-:|
+| ![Celestial](../assets/wallpapers/thumbs/lumo/lordos-lumo-celestial.jpg)<br>**Celestial** (default desktop) | ![Aurora](../assets/wallpapers/thumbs/lumo/lordos-lumo-aurora.jpg)<br>**Aurora** |
+
+| | Cosmos | | |
+|:-:|:-:|:-:|:-:|
+| ![Event Horizon](../assets/wallpapers/thumbs/cosmos/lordos-event-horizon.jpg)<br>**Event Horizon** | ![Infinite Galaxy](../assets/wallpapers/thumbs/cosmos/lordos-infinite-galaxy.jpg)<br>**Infinite Galaxy** | ![Solar Odyssey](../assets/wallpapers/thumbs/cosmos/lordos-solar-odyssey.jpg)<br>**Solar Odyssey** | ![Stellar Voyage](../assets/wallpapers/thumbs/cosmos/lordos-stellar-voyage.jpg)<br>**Stellar Voyage** |
+
+- **Defaults:** new users start on **Celestial** (Lumo); the login screen and the remote login page
+ use **Crystal Crown**. Users who already chose a wallpaper keep it.
+- **Size:** the originals are 1672×941. They ship as high-quality JPEG (about 4 MB for all eleven
+ instead of 23 MB of PNG) with 320×180 thumbnails for the pickers. On 4K screens they look soft;
+ a `lordos-<name>@3840x2160` version added to the collection is picked automatically on screens
+ that need it.
+- **License and provenance:** iPERFEX created the images with an AI image generator; they are
+ not hand-drawn. They ship under the repository's terms (MIT) like
+ the rest of the brand kit, and the name, crown and Lumo in them fall under the trademark and brand
+ policy. AI-generated images may get limited copyright protection in some countries; the
+ trademark policy still applies.
+- **Lumo pieces:** Celestial and Aurora are an artistic interpretation of the celestial fox, with a
+ long flowing tail. They don't replace the mascot drawings in section 6; for Lumo in the interface,
+ use the brand kit.
+- **Do** use them as desktop, login and promotional backgrounds for LordOS, with the logo on top
+ following section 5.
+- **Don't** crop the crown out of Crystal Crown for use as a logo, or present them as another
+ project's artwork.
diff --git a/docs/VM-SETUP.md b/docs/VM-SETUP.md
index 03f5f28..b80326d 100644
--- a/docs/VM-SETUP.md
+++ b/docs/VM-SETUP.md
@@ -1142,3 +1142,22 @@ folder `~/LordOS-monred`, installed into `/usr/local/lib/lordos` as in step 15 (
`lord-qmp-input.py 118 2987 1067` (the VM has two heads, see "Several displays").
- The session language, theme and accent were changed for the screenshots and restored from
`~/.config-lordos-backup-monred` afterwards.
+
+## Step 29 — New wallpapers (VM 123 `lordos-monitor`, October 19)
+
+Tree in `~/LordOS-wp`, built there (`make -C server -j4`, `make -C server test`: 23 passed,
+3 skipped). Nothing was installed with apt.
+
+- **Deployment, temporary:** `/usr/local/lib/lordos` was copied to `lordos.wp123-bak`, the new
+ `lord-server`, `lord-sessiond`, `lord-vault`, `lord-maild`, the themes and `assets/` were installed
+ over it, and the collection went to `/usr/share/backgrounds/lordos` with the
+ `assets/wallpapers` link, as the package does. Afterwards the backup was copied back, the files
+ that only the new build had were removed (`diff -rq` against the backup: identical), and
+ `/usr/share/backgrounds/lordos` was deleted.
+- **New user:** `~/.config/lordos/settings.json` was replaced by `{"language": "en"}` for the
+ screenshots (Celestial by default, then Crystal Crown and light mode chosen in Settings) and
+ restored from its backup (`wallpaper: "sunset"` again).
+- **Login screen:** the session from before the deploy was ended and `/run/lordos/autologin-done`
+ removed to show the greeter and then autologin again; `/etc/lordos/session.conf` wasn't changed.
+- **Screenshots** with `screendump` from the Proxmox host, the pointer with
+ `lord-qmp-input.py 123 1280 800`. eth0 and the VM's network weren't touched.
diff --git a/docs/wallpapers-desktop.png b/docs/wallpapers-desktop.png
new file mode 100644
index 0000000..793ede7
Binary files /dev/null and b/docs/wallpapers-desktop.png differ
diff --git a/docs/wallpapers-login.png b/docs/wallpapers-login.png
new file mode 100644
index 0000000..269c327
Binary files /dev/null and b/docs/wallpapers-login.png differ
diff --git a/docs/wallpapers-settings-dark.png b/docs/wallpapers-settings-dark.png
new file mode 100644
index 0000000..509cfec
Binary files /dev/null and b/docs/wallpapers-settings-dark.png differ
diff --git a/docs/wallpapers-settings-light.png b/docs/wallpapers-settings-light.png
new file mode 100644
index 0000000..1771036
Binary files /dev/null and b/docs/wallpapers-settings-light.png differ
diff --git a/themes/README.md b/themes/README.md
index 45bbaf9..d55b6c0 100644
--- a/themes/README.md
+++ b/themes/README.md
@@ -62,7 +62,10 @@ Images (`<Image src="assets/...">`) are resolved relative to the theme's folder.
`mode`, `accent`, `text`, `textDim`, `windowBg`, `sidebarBg`, `separator`, `hover`, `control`,
`inputBg`. Optional: `gtkButtons` (order of the GTK apps' buttons, e.g. `':minimize,maximize,close'`; by default the traffic lights on the left, see `docs/WAYLAND.md`), `accents` (name → color map, for Settings), `wallpapers`
-(`[{ id, name, src }]`). The theme can add any tokens of its own.
+(`[{ id, nameKey, name, src, thumb?, category?, variants? }]`; Settings groups them by `category` and
+shows `thumb` in its grid; add `lordosWallpapers` from the SDK to offer the LordOS collection, and
+draw with `wallpaperSrc(w, width, height)` so a higher-resolution variant is used where it exists,
+see `assets/wallpapers/README.md`). The theme can add any tokens of its own.
## Native components