An Omarchy-inspired, opinionated desktop for FreeBSD.

One command. A complete tiling system. ZFS underneath, Rust in the middle, Tokyo Night on top.

fetch https://raw.githubusercontent.com/cdomin1/Vellum-BSD/main/boot.sh -o - | sh
Try it in your browser Get the image

Everything installed. Nothing to configure.

Keyboard-driven tiling

vellum-wm — a Rust tiling WM on penrose/x11rb. Omarchy keymap, workspaces 1–9, gaps, themed borders. No mouse required.

Animated X11

picom 13 animates window open, close and tiling moves, with rounded corners and soft shadows. Runs on a plain framebuffer — works in VMs, no KMS handshake.

22 themes

Every Omarchy palette ported. One command re-themes the terminal, launcher, panel, borders and wallpaper.

Power that thinks

AC/battery profiles via devd, adaptive CPU with powerdxx, ThinkPad charge thresholds, S3/s2idle suspend that locks before it sleeps. Lid, sleep button and zzz all covered.

GPU autodetect

Intel, AMD & NVIDIA — including hybrids and five driver generations. The boot GPU drives the desktop, prime-run hands work to the dGPU.

Inline installer

An Omarchy-style guided wizard: keymap → disk → ZFS → user → done. Live logs to /var/log, unattended installs via a config file, first-boot setup.

Connectivity

vellum wifi scans and joins networks; vellum bt drives the netgraph Bluetooth stack — scan, PIN pair, connect. Experimental, like the platform they ride on.

Scratchpad & menus

Super+S drops a floating terminal on any workspace. Super+Alt+Space opens rofi menus for system, theme, power, capture, network and Bluetooth.

ArtCraft

Storytold's AI studio builds on FreeBSD via scripts/install-artcraft.sh — the pure-Rust egui app, no Tauri. Experimental, bundled by build script.

alacritty — vellum doctor
$ vellum doctor
  ✓ vellum-wm installed
  ✓ polybar installed
  ✓ picom installed
  ✓ gpu detected / driver — i915kms, hybrid (intel+nvidia), prime-run ready
  ✓ suspend support — S3 via zzz, lid → suspend, slock on wake
  ✓ power profiles — balanced on AC, power on battery (devd)

$ vellum theme set gruvbox
  linked ~/.config/vellum/current/theme → gruvbox
  wallpaper applied · polybar restarted

Muscle memory, imported

Super+⏎terminal
Super+Spacelauncher
Super+⌥+Spacemenus
Super+Bbrowser
Super+⇧+Ffiles
Super+Ffullscreen
Super+Sscratchpad
Super+Tmonitor
Super+Qclose
Super+1–9workspaces
Super+/all keys
Super+Escpower menu
Super+⇧+Escsuspend
Printscreenshot

22 palettes. One command.

vellum theme set gruvbox · vellum theme next

tokyo-night
catppuccin
catppuccin-latte
ethereal
everforest
flexoki-light
gruvbox
hackerman
kanagawa
last-horizon
lumon
lupine
matte-black
miasma
nord
osaka-jade
retro-82
ristretto
rose-pine
solitude
vantablack
white

Get the image

Named by install target — pick yours:

usbamd64-usb-installer.img.xz — x86-64 PC & Intel Mac
isoamd64-vm-installer.iso.xz — x86-64 VMs
usbaarch64-usb-installer.img.xz — arm64 (Apple Silicon)
isoaarch64-vm-installer.iso.xz — Parallels / UTM on Apple Silicon
Downloads

Why FreeBSD?

ZFS root with bectl boot environments — the snapshot-and-rollback story, natively. A coherent base system instead of a kernel plus thirty vendors. Jails when you want isolation. Ports when you want the source.

Same contract as Omarchy: one command, a fully-working, opinionated desktop. Just on a different kernel.