A Wayland-native Linux desktop written from scratch in Rust — compositor, shell, bar, dock, notifications, settings and a phone bridge — plus the Arch-based distribution that ships them.
CrownOS is early. It builds and it runs, and it is not yet something you install on your only laptop. The table of what is verified says exactly what works today, component by component. Nothing here describes software that does not exist.
| You are… | Go to |
|---|---|
| curious what this is | crownOs — the desktop, and how it fits together |
| setting up any Linux machine | crownOs-setup — one script, any distribution |
| wanting to build and run it | Build it |
| wanting to contribute | CONTRIBUTING.md |
| wanting to test and report bugs | What is verified, then open an issue on crownOs |
crownpositor the Wayland compositor; it *is* the
(the Wayland server) session, and spawns the rest
│
┌─────────────┼──────────────┬──────────────┐
crownbar crowndock crownotify crowndictator
└─────────────┴──────────────┴──────────────┘
│ all built on
crownshell layer-shell + Vello framework
crownos-config settings schema, read live by everything above
crownuikit widget kit (xilem) for the settings surfaces
crowncrate-* phone bridge: Linux daemon, Android and Chrome clients
lls-protocol low-latency screen-streaming protocol
crownos-iso the installation image
crownos-setup native dependencies and toolchain, on any distribution
everything above the crowncrate line lives in one repo: Crown-OS/crownOs
| Repo | What it is |
|---|---|
| crownOs | The desktop. Nine crates in one workspace: compositor, shell framework, bar, dock, notifications, dictation, config schema, widget kit — and the documentation |
| crownOs-setup | Native dependencies and toolchain, on any distribution |
| crownos-iso · crownos-website | Installation image; website |
| crowncrate-linux · crowncrate-android | Phone bridge |
| lls-protocol | Low-latency streaming protocol |
| crownlauncher | Application launcher |
The per-crate repositories — crownshell, crownos-config, crownbar, crowndock,
crownotify, crowndictator, crownuikit, crownpositor — are archived. Their
URLs still resolve and their history is intact; the code moved into crownOs so
that a change crossing two crates is one commit, one review and one CI run.
Crate names on crates.io are unchanged.
MIT, except crownos-iso, which is GPL-3.0-or-later because it derives from Arch Linux's archiso profile.
