Cocoa-Way
A native macOS Wayland compositor written in Rust that enables seamless Linux app streaming without XQuartz.
What is Cocoa-Way?
Cocoa-Way is a native Wayland compositor for macOS, built with Rust and Smithay, that allows users to run Linux applications directly on macOS with native window integration. It provides a modern alternative to XQuartz by using the Wayland protocol for lower latency and better HiDPI support, connecting directly to Linux via Unix sockets or SSH without requiring a virtual machine.
macOS developers and users who need to run Linux GUI applications natively on their Mac, particularly those seeking a low-latency, HiDPI-optimized alternative to XQuartz or VNC solutions.
Developers choose Cocoa-Way for its zero VM overhead and native macOS window integration, offering lower latency and better Retina display support compared to legacy X11 solutions like XQuartz, while being easier to set up than full virtual machine GUI environments.
Overview
Native macOS Wayland Compositor written in Rust using Smithay. Experience seamless Linux app streaming on macOS without XQuartz.
Use Cases
Best For
- Running Linux GUI applications like Firefox on macOS with native window management and server-side decorations.
- macOS users with Retina displays who need proper HiDPI scaling for Linux applications.
- Developers seeking a low-latency alternative to XQuartz or VNC for accessing Linux apps from macOS.
- Users who want to connect to Linux applications via SSH or Unix sockets without the overhead of a virtual machine.
- Integrating Linux development tools into a macOS workflow with seamless window integration.
- Projects requiring a modern Wayland-based compositor on macOS built with Rust and Smithay.
Not Ideal For
- Users needing to run Windows applications or non-Linux GUI software on macOS
- Projects requiring zero-latency performance for graphics-intensive or real-time applications like gaming
- Teams that need a production-ready, stable solution for critical workflows without known lag issues
- Environments where full virtual machine isolation or containerized GUI is necessary for security or compatibility
Pros & Cons
Pros
Renders Linux applications as native macOS windows with server-side decorations, shadows, and focus indicators, providing seamless desktop integration without X11 quirks.
Connects directly via Unix sockets or SSH using the Wayland protocol, avoiding the performance and resource hit of virtualization, as highlighted in the comparison table.
Optimized for Retina displays with proper scaling and high-resolution rendering, offering better HiDPI support than alternatives like XQuartz or VNC.
Uses an efficient OpenGL rendering pipeline for smooth performance, leveraging macOS's graphics capabilities for better responsiveness.
Cons
The README admits that due to HiDPI use, there is significant lag when remotely connecting to Linux, making it temporarily unable to replace VNC for latency-sensitive tasks.
Requires installation of waypipe-darwin and specific SSH configurations, adding setup complexity compared to drop-in solutions like XQuartz.
At version 0.2.0 with features like multi-monitor support still in the roadmap, it may have bugs or incomplete functionality for production use.
Open Source Alternative To
Cocoa-Way is an open-source alternative to the following products:
Frequently Asked Questions
Related Projects
BatA cat(1) clone with wings.
fdA simple, fast and user-friendly alternative to 'find'
nushellA new type of shell
zoxideA smarter cd command. Supports all major shells.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.