OPEN SOURCE / MACOS

cocoa-way.

Wayland windows. Native macOS.

A native Wayland compositor and Metal renderer that brings Linux desktops and applications to macOS.

Latest public releasev2.1.2

01 / LINUXWayland clientsDesktop or applications

02 / TRANSPORTWaypipeRemote or local backend

03 / MACOScocoa-wayMetal → native windows

ARCHITECTURE SKETCH / LINUX → MACOS

CURRENT CAPABILITIES

One desktop. Or individual windows.

[ A ]

Desktop mode places a Linux desktop inside one compositor window. Rootless mode gives supported Wayland applications their own macOS windows.

[ B ]

Connect through SSH and Waypipe, or use local Apple Container, Docker and OrbStack workflows.

[ C ]

Clipboard, audio and input forwarding, application controls and diagnostics connect the Linux session with the macOS side.

DEVELOPMENT NOTES

v2.1.2 improves Apple Container compatibility and dependency diagnostics. The project is actively evolving.

01
End-to-end latency is still under investigation.
02
Release bundles are ad-hoc signed and are not Apple-notarized.
03
Apple Container is installed separately and has its own Apple silicon and macOS requirements. Container guests have no GPU passthrough.
04
Rootless mode targets Wayland xdg-shell applications. X11 applications require Xwayland inside Linux.

KEEP EXPLORING

The README and release notes are the reference for current setup, supported workflows and known limitations.