Share your Hyprland desktop with a Mac's Screen Sharing app or RDP clients like Windows App and FreeRDP.
| Client | Quickstart |
|---|---|
| Mac Screen Sharing | Connect from your Mac |
| Windows App on iPhone, iPad, or Mac | Connect with Windows App |
| Windows Remote Desktop Connection (mstsc) | Connect with mstsc |
| FreeRDP | Connect with FreeRDP |
- Use your Hyprland and Omarchy shortcuts.
- On the Mac, copy text, rich text, and images. Use High Performance for video and sound.
- On RDP, use H.264 or Planar graphics. Live resize and rotation work on iPhone.
RDP is on by default on port 3389 at the Apple listen address. See the tested clients for each client's verified behavior.
Watch the 40-second demo
demo.mp4
Install on your Hyprland machine. Requires Hyprland 0.56 or newer and systemd. Builds are available for x86_64 and ARM64.
wayshare is in the Omarchy package repository:
omarchy pkg add wayshareFor now the package is only on Omarchy's edge channel. It reaches stable when Omarchy
promotes it. Until then, pacman -Si wayshare on stable says it isn't found.
curl -fsSL https://raw.githubusercontent.com/wesleygrimes/wayshare/main/install.sh | shInstalls to ~/.local/bin. No sudo required.
If you use mise, run:
mise use -g github:wesleygrimes/wayshareTo build it yourself, see Build from source.
Run this in a terminal inside your Hyprland session:
wayshare setupChoose a password, the monitor to share, and the network for Apple Screen Sharing. Setup saves your choices, starts wayshare, and displays the address and username. Both protocols use that username and password. Setup offers ufw rules for TCP 5900 and 3389. On an existing install, rerun setup or open TCP 3389 to your LAN or VPN.
The network choice applies to both protocols. RDP uses the same address on port
3389 unless [rdp] listen sets its own. See Security for VPN
access.
Run wayshare setup again to change your choices. For
other settings, edit ~/.config/wayshare/config.toml, then run
wayshare restart.
On a Mac, open Screen Sharing and connect to the address from setup. Sign in with the username from setup and your wayshare password. Follow the Mac quickstart for High Performance mode.
In an RDP client, use your Hyprland machine's address and port 3389. Use the same username, with an empty domain. Check the certificate's SHA-256 fingerprint before you send your password. Follow the Windows App and mstsc or FreeRDP quickstart.
For connection or startup problems, run wayshare doctor and see
Troubleshooting. For RDP, doctor checks the ufw rule
but does not connect to the listener.
| Command | What it does |
|---|---|
wayshare setup |
Set up or change the password, monitor, and network |
wayshare doctor |
Check the setup and explain how to fix problems |
wayshare start |
Start the service |
wayshare stop |
Stop the service |
wayshare restart |
Restart the service after configuration changes |
wayshare upgradeInstalls the latest release and restarts the service.
For version 0.1.5 or older, run the install command again, then wayshare restart.
On Omarchy, omarchy-update upgrades wayshare with the rest of the system. Then run
wayshare restart.
wayshare uninstallStops the service and removes wayshare. Keeps ~/.config/wayshare.
With mise, run wayshare uninstall before mise uninstall.
On Omarchy, run wayshare uninstall, then omarchy pkg drop wayshare.
- Client compatibility
- Configuration
- High Performance mode
- RDP
- Security
- Troubleshooting
- Packaging
- Development
Thanks to these people (emoji key):
Wes Grimes 💻 📖 🚧 |
Andre Alves 🐛 🤔 💻 |
Kit Knox 💻 🐛 📓 |
kyler 💻 🐛 |
ernestodisa 🐛 🤔 |
Snowy 📓 |
Brandon Smith 💻 |
ChachizR 💻 |
3j27 💻 🐛 📦 |
This project follows the all-contributors specification. To contribute, see CONTRIBUTING.md.
wayshare is free. If it's useful, you can sponsor the work or buy me a coffee.
Apache-2.0. See LICENSE.
