Install Wawona from Download, TestFlight, or Discord. Build from source if you need to.

Wawona is a native Wayland compositor. You do not need Nix to run a binary.

Versioning is CalVer YY.M.D (see GitHub tags like v26.8.12). Older 0.x marketing versions are retired.

macOS is not a store feature target. Do not wait for a Mac store listing.

Wawona Machines on macOS with nested Weston and Niri clients
Machines on macOS. Start a profile, then Focus to show the compositor. Nested Weston and Niri clients sit beside the catalog. Gallery

Get a build

  1. Download for GitHub assets (Wawona-{calver}-{platform}-{arch}.{ext}: dmg, ipa, apk, AppImage) when a v* tag ships. See Prebuilt binary naming.
  2. TestFlight / Play beta. Find testing links on the Wawona Discord. Play ships internal (CI smoke) on every green master tip. Closed Alpha is the interim external channel while Open testing waits on Play production access. When Open testing is live, Discord carries the public opt-in link. Store filenames include the build number; see the same naming doc.
  3. Apple family schemes exist for iOS, iPadOS, tvOS, watchOS, and visionOS. Android and Linux too.
Wawona Machines and nested clients on iPad
Same Machines flow on iPadOS. One window per Wayland client, plus the in-app modifier keyboard. Gallery
Wawona Machines and Weston terminal on Apple Vision Pro
visionOS matches macOS for nested compositors and multi-window Machines. Weston terminal in spatial windows. Gallery

First run

Open Wawona. Create or pick a Machine. Start it. Use Focus to show the compositor.

Before tapping Weston panel icons or nested clients, set Touch Input Type to Multi-Touch (iOS family) or turn Touchpad Mode off (Android). See Usage. Typing follows the host keyboard and IME. There is no layout picker. See Keyboard and IME.

Extra software

Two catalogs. Pick a lane at repo.wawona.io/search.

  • App Store / Play: search wasm, then wpm install in the Wawona shell. Wasm only.
  • Jailbroken iOS: add https://repo.wawona.io/ in Sileo (rootless and rootful).
  • Sideloaded Android: add the same URL in Termux apt. Termux is not jailbreak and not Play.

See Packages.

Build from source

Contributors: Compilation, Nix, reproducible direnv + Nix, and AI + MCP. You need Nix, Xcode on Apple, and local signing inputs in ignored .envrc.local for signed iOS family builds.

nix run .#wawona-macos
nix run .#wawona-ios
nix run .#wawona-android
nix run .#wawona-linux

Other attributes: wawona-macos-desktop-host, wawona-watchos-app-sim, wawona-tvos-sim, wawona-visionos-sim.

Report a bug

If a machine does nothing after Start, copy logs from Settings → About and open a GitHub issue. See Report a bug.