True protocol portability: Cocoa-Way rendering Linux apps from SSH hosts, Docker, OrbStack, and Apple Container.

brew tap J-x-Z/tap
brew install cocoa-way waypipe-darwin

Download the latest .dmg or .zip from Releases.

# Install dependencies
brew install libxkbcommon pixman pkg-config

# Clone and build
git clone https://github.com/J-x-Z/cocoa-way.git
cd cocoa-way
cargo build --release

⚠️ Required: You must install waypipe-darwin to connect Linux apps.

brew tap J-x-Z/tap && brew install waypipe-darwin

1. Start the compositor:

   cocoa-way

2. Connect Linux apps via SSH:

   ./run_waypipe.sh ssh user@linux-host firefox

3. Or add persistent container sessions in ~/.config/cocoa-way/container-sessions.toml:

   [[session]]
   name = "Ubuntu (Apple Container)"
   runtime = "container"
   image = "docker.io/library/ubuntu:24.04"
   profile = "single-app"
   app = "weston-terminal"
   container_socket = "/tmp/cocoa-way/waypipe.sock"
   runtime_args = ["--rosetta"]

   Then use the Container menu inside Cocoa-Way to launch the session.

Cocoa-Way has two control modes: Classic connections for SSH / local sockets, and Container Mode for local Linux GUI sessions managed by Cocoa-Way.

• runtime = "container" uses Apple's official container CLI. Apple documents it as requiring Apple silicon and macOS 26+, and you must start its background service first with container system start.
• runtime = "docker" works with Docker Desktop and compatible CLIs.
• runtime = "orb" or runtime = "orbstack" works with OrbStack.

For Apple Container, Cocoa-Way uses container run --publish-socket ... so the waypipe socket is exported back to macOS without requiring a shared bind mount. For Docker and OrbStack, Cocoa-Way bind-mounts the host socket directory into the container and connects over that local socket.

graph LR
    subgraph macOS
        CW[Cocoa-Way<br/>Compositor]
        WP1[waypipe<br/>client]
    end
  
    subgraph Linux VM/Container
        WP2[waypipe<br/>server]
        APP[Linux App<br/>Firefox, etc]
    end
  
    APP -->|Wayland Protocol| WP2
    WP2 <-->|SSH/Socket| WP1
    WP1 -->|Wayland Protocol| CW
    CW -->|Metal| Display[macOS Display]

• macOS backend (METAL)
• Waypipe integration
• HiDPI scaling
• winit and objc update
• Multi-monitor support
• Clipboard sync

waypipe ssh -o StreamLocalBindUnlink=yes user@host ...

container system start
container run --rm -it ubuntu:24.04 /bin/bash

Contributions welcome! Please open an issue first to discuss major changes.

GPL-3.0 - Copyright (c) 2024-2025 J-x-Z