November 19, 2026

WayShare lets a Mac or an RDP client take control of your Omarchy desktop

0

Wes Grimes’ WayShare turns a Hyprland machine into a remote desktop for Apple’s Screen Sharing app and RDP clients, and it is already in the Omarchy package repository on the edge channel.

Want to drive your Omarchy box from the couch with a MacBook, or from an iPhone? WayShare, an Apache-2.0 project by Wes Grimes, shares a Hyprland desktop with a Mac’s built-in Screen Sharing app and with RDP clients like Windows App, Windows Remote Desktop Connection (mstsc) and FreeRDP. According to the README, you keep using your Hyprland and Omarchy shortcuts on the remote side.

The feature list depends on the client. On the Mac, you can copy text, rich text and images, and switch to High Performance mode for video and sound. Over RDP, WayShare uses H.264 or Planar graphics, and live resize and rotation work on iPhone. RDP is on by default on port 3389, and Mac Screen Sharing connects on port 5900.

Installing on Omarchy is a one-liner: omarchy pkg add wayshare. The README adds a caveat: “For now the package is only on Omarchy’s edge channel. It reaches stable when Omarchy promotes it.” That may already be out of date, as the Starry Hope guide below says its test install with that same command ran on Omarchy’s stable channel. Either way, the project also offers an install script that puts the binary in ~/.local/bin without sudo, and a mise use -g github:wesleygrimes/wayshare option. WayShare needs Hyprland 0.56 or newer and systemd, with builds for x86_64 and ARM64.

Setup happens in a terminal inside your Hyprland session with wayshare setup. You pick a password, the monitor to share and the network to listen on, and setup offers ufw firewall rules for TCP 5900 and 3389. From there, wayshare doctor diagnoses problems, start, stop and restart control the service, and wayshare uninstall removes it. On Omarchy, omarchy-update upgrades it with the rest of the system.

The latest release, v0.4.0, came out on November 12, 2026. According to its release notes, setup now offers a ufw rule for the two UDP ports High Performance mode uses (5960 and 5962 by default), without which High Performance audio starts a few seconds late, and wayshare doctor warns when they are missing. Physical monitors now only switch to resolutions they actually list when resizing is on.

Starry Hope put it through its paces in a video, “WayShare: Control an Omarchy PC from Your Mac’s Built-in Screen Sharing”, and in a written guide by Jim Mendenhall published on November 18, 2026. The guide’s tests ran WayShare 0.4.0 on Omarchy 4.5 on an Intel N100 mini PC, controlled from an M4 Mac mini. According to the guide, Command works as the Super key in Omarchy shortcuts, so Command+Enter opens a terminal.

The guide’s performance numbers are worth knowing before you try it on a small machine. When a Mac with a 4K display asked for a full 3840 by 2160 picture in High Performance mode, the N100 played video at about 7 frames a second. At 1920 by 1080, it sent a steady 30 frames a second. The guide notes those 1080p results came from a virtual display, and recommends setting the monitor to 1920×1080 at scale 1 with resize = false in the WayShare config.

Starry Hope also flags a security point: in Standard mode, the picture and the clipboard are not encrypted, so anyone on the same network could see them. The advice is to stick to a trusted network or a VPN, and to choose a WayShare password you don’t use anywhere else, including your Omarchy login.

Source: https://github.com/wesleygrimes/wayshare

Leave a Reply

Your email address will not be published. Required fields are marked *