Skip to content
OpenCharly

omarchy-cstream

Recipe card from the charly-distros plugin (Images — the deployable catalog).

omarchy-cstream

Section titled “omarchy-cstream”

The Omarchy desktop, streamed to a browser — Hyprland with its Quickshell shell. The GUI edition of the Omarchy image family: the base image plus the cstream transport spine, a nested Hyprland, and Omarchy’s own shell, terminal, themes and fonts. What a user gets is the real Omarchy desktop — the Quickshell bar, notifier, launcher and OSD from /usr/share/omarchy/shell — reachable over HTTPS instead of over a monitor cable.

Why cstream and NOT selkies

Section titled “Why cstream and NOT selkies”

charly has two pod-GUI stacks and they are not interchangeable. Selkies (pixelflux) hosts labwc and KDE. It CANNOT host Hyprland, and the reason is a protocol version, not a missing GPU:

wl_registry#2: error 0: invalid version for global wl_compositor (2):
expected at most 5, got 6
terminate called after throwing an instance of 'std::runtime_error'
  what():  CBackend::create() failed!

Hyprland binds wl_compositor at v6; pixelflux advertises at most v5. No env knob, device mapping or render node fixes that. pod-hyprland’s own description records the same constraint from the other side — the parent must advertise zwp_linux_dmabuf_v1 AND bind xdg_wm_base at version 6, and gst-wayland-display (Smithay) is what clears both. layer-cstream-desktop is that parent plus the compositor, composed as one name.

Why it BASES on omarchy rather than composing omarchy-base

Section titled “Why it BASES on omarchy rather than composing omarchy-base”

omarchy-repo repoints pacman at Omarchy’s frozen mirror snapshot, and that only governs candies ordered after it. A require: cannot be added to somebody else’s layer, so composing omarchy-base as a peer candy let layer-gst-wayland-display and pod-cstream install gstreamer 1.28.6-3 from UPSTREAM Arch first; pod-cstream’s own gst-plugins-good then resolved to the snapshot’s 1.28.6-2 and the transaction died outright with installing gstreamer (1.28.6-2) breaks dependency 'gstreamer=1.28.6-3'. Deriving FROM the base image puts the repository configuration in the FROM layer, where every later package in every later candy inherits it.

Verification

Section titled “Verification”
  • charly -C box/omarchy check box omarchy-cstream — build-scope probes
  • The streamed desktop bed: the nested Hyprland + Quickshell shell reachable over HTTPS (the check-cstream-* beds)

When to Use This Skill

Section titled “When to Use This Skill”

MUST be invoked when the task involves the omarchy-cstream box, the streamed Omarchy desktop, or the cstream transport spine.

Section titled “Related”