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.

README: describe LordOS; About: add tagline

Federico Pereira1ce8b94bca31
diff --git a/README.md b/README.md
index a9285f9..f3e81c7 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,44 @@
# LordOS
-A desktop environment of its own for Linux (Debian 13), with a real graphics server written
-**from scratch in C** and a user interface built with **React**.
-Lightweight, designed for low-end machines.
+**A free, fast and secure desktop operating system, built from scratch on Linux.**
-- `server/`: `lord-server`, the graphics server. It uses DRM/KMS and evdev straight from the
- kernel, without X11, Wayland, libdrm or libinput.
+LordOS is based on Debian 13, but it doesn't use GNOME, KDE or X11. It has its own display
+server written in C and its own React-based UI engine, and an idle session uses about 120 MB
+of RAM. Its look and workflow take inspiration from the desktop of a well-known
+fruit-logo company: a Dock, an app launcher, a menu bar, instant search and polished native
+apps, all reimagined as free software. It runs on Intel/AMD PCs and on the Raspberry Pi 5, and
+it still runs regular Linux apps such as Chromium, Firefox, GTK and Qt programs.
+
+## Four pillars
+
+1. **Our own, end to end.** Display server, Wayland compositor and UI engine; login, sessions
+ and remote desktop; app store and package installer; firewall; password manager; touchpad
+ driver. All written for LordOS.
+2. **Light and smooth.** Built for modest hardware: about 120 MB at rest and 0 % CPU when idle,
+ windows that move at the display's refresh rate, GPU composition when available and a CPU
+ path when not.
+3. **Secure by design.**
+ - Third-party apps run sandboxed in their own process and ask before using the camera,
+ microphone, files or network.
+ - Every app gets kernel-enforced network rules (allow, block, LAN-only, per domain).
+ - A built-in Monitor shows network and hardware activity per app, with a world map.
+ - Signed packages, capture-protected windows and an encrypted password vault.
+4. **Complete and polished.** More than 35 native apps (Files, Mail, Calendar, Contacts,
+ Photos, Player, PDF viewer, Passwords, Disks, Backups and more), multiple monitors with
+ sharp fractional scaling, touchpad gestures, multi-user sessions, remote desktop from any
+ browser, and English, Spanish and Portuguese, including right-to-left scripts.
+
+Status: **0.7.0 Beta** (see `CHANGELOG.md` and `docs/ROADMAP.md`). License: MIT.
+
+## Repository map
+
+- `server/`: `lord-server` (the display server: DRM/KMS and evdev straight from the kernel,
+ without X11, libdrm or libinput) plus `lord-sessiond`, `lord-netd`, `lord-netperm` and the
+ sandboxed helpers (`lord-media`, `lord-doc`, `lord-vault`, `lord-maild`).
- `docs/ARCHITECTURE.md`: layers, dependency policy and theme model.
- `docs/ROADMAP.md`: milestones and status.
- `docs/VM-SETUP.md`: development VM on Proxmox, step by step.
-- `docs/TERMINAL.md`: the native terminal (iTerm2-style), shortcuts and parity with iTerm2.
+- `docs/TERMINAL.md`: the native terminal, its shortcuts and features.
- `docs/WAYLAND.md`: Linux apps (GTK, Qt) as LordOS windows with our own Wayland compositor.
- `docs/LANGUAGES.md`: language and region across the whole system (es, en, pt and language
packs), complex scripts (Arabic, Hebrew, CJK, mirrored UI) and input methods.
@@ -18,7 +47,7 @@ Lightweight, designed for low-end machines.
- `sdk/`: `@lordos/sdk`, the API for themes and apps (windows, settings, files, system).
- `apps/`: native apps as packages. See `apps/README.md`.
- `themes/`: themes (complete desktops) in React, swappable live. See `themes/README.md`.
-- `third_party/`: QuickJS and stb, vendored. `assets/fonts/`: Inter and JetBrains Mono (OFL).
+- `third_party/`: QuickJS, stb, Monocypher and word lists, vendored (see `THIRD_PARTY.md`). `assets/fonts/`: Inter and JetBrains Mono (OFL).
- `assets/locales/`: UI texts per language. `tools/i18n-check.mjs` and `tools/i18n-pack.mjs`.
- `server/src/term/`: our own terminal (xterm emulator, PTY, drawing); the app is in `apps/terminal/`.
@@ -40,6 +69,11 @@ cd server && sudo ./build/lord-server # drops root on startup; quit: Ctrl+Al
It must run from a text console, with no other graphical environment active.
+## Building the ISO
+
+See `docs/ISO.md` (live USB for PCs) and `docs/RASPBERRY.md` (SD/NVMe image for the
+Raspberry Pi 5).
+
## License
-MIT for LordOS's code. Each vendored dependency keeps its own license.
+MIT for LordOS's code. Each third-party component keeps its own license (see `THIRD_PARTY.md`).
diff --git a/apps/about/index.jsx b/apps/about/index.jsx
index 22462e1..8b80e02 100644
--- a/apps/about/index.jsx
+++ b/apps/about/index.jsx
@@ -32,6 +32,7 @@ export default function About() {
<Text style={{ fontSize: typeScale.largeTitle, fontWeight: 600, color: t.text, marginTop: 12 }}>LordOS</Text>
<Text style={{ fontSize: typeScale.callout, color: t.textDim, marginTop: 2 }}>{ver.channel ? tr('about.versionChannel', { v: ver.version, channel: ver.channel }) : tr('about.version', { v: ver.version })}</Text>
{ver.build ? <Text style={{ fontSize: typeScale.caption, color: t.textDim, marginTop: 1 }}>{tr('about.build', { b: ver.build })}</Text> : null}
+ <Text style={{ fontSize: typeScale.callout, color: t.textDim, marginTop: 10, maxWidth: 320, textAlign: 'center', lineHeight: 17 }}>{tr('about.tagline')}</Text>
<View style={{ alignSelf: 'stretch', marginTop: 16, gap: 2 }}>
<InfoRow k={tr('about.os')} v={info.os} />
<InfoRow k={tr('about.kernel')} v={`${info.kernel} (${info.arch})`} />
diff --git a/assets/locales/en/about.json b/assets/locales/en/about.json
index ad5852b..2f6178f 100644
--- a/assets/locales/en/about.json
+++ b/assets/locales/en/about.json
@@ -26,6 +26,7 @@
"other": "{ms} ms · {count} nodes"
},
"server": "Display server",
+ "tagline": "A free, fast and secure desktop, built from scratch on Linux.",
"uptime": "Uptime",
"version": "Version {v}",
"versionChannel": "Version {v} · {channel}"
diff --git a/assets/locales/es/about.json b/assets/locales/es/about.json
index f194607..e94e0ee 100644
--- a/assets/locales/es/about.json
+++ b/assets/locales/es/about.json
@@ -26,6 +26,7 @@
"other": "{ms} ms · {count} nodos"
},
"server": "Servidor gráfico",
+ "tagline": "Un escritorio libre, rápido y seguro, construido desde cero sobre Linux.",
"uptime": "Encendido hace",
"version": "Versión {v}",
"versionChannel": "Versión {v} · {channel}"
diff --git a/assets/locales/pt/about.json b/assets/locales/pt/about.json
index e5be5f4..1c9a222 100644
--- a/assets/locales/pt/about.json
+++ b/assets/locales/pt/about.json
@@ -26,6 +26,7 @@
"other": "{ms} ms · {count} nós"
},
"server": "Servidor gráfico",
+ "tagline": "Um desktop livre, rápido e seguro, construído do zero sobre Linux.",
"uptime": "Ligado há",
"version": "Versão {v}",
"versionChannel": "Versão {v} · {channel}"