Getting Started

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 internal. Find beta testing links on the Wawona Discord. Store builds ship from Ship: beta (stores) on master (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.

Build from source

Contributors: Compilation, Nix, and AI + MCP (wire wwn-mcp so agents retrieve Wawona knowledge). You need Determinate Nix, Xcode on Apple, and TEAM_ID in .envrc 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.