Skip to content
wesleygrimesPublic

About

Share your Hyprland desktop with a Mac's Screen Sharing app or RDP clients like Windows App and FreeRDP.

Topics

Resources

Contributing

Security policy

Stars

64 stars

Watchers

2 watching

Forks

Repository files navigation

wayshare

Share your Hyprland desktop with a Mac's Screen Sharing app or RDP clients like Windows App and FreeRDP.

Connect from

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.

An Omarchy desktop open in the Mac's Screen Sharing app

Watch the 40-second demo
demo.mp4

Install

Install on your Hyprland machine. Requires Hyprland 0.56 or newer and systemd. Builds are available for x86_64 and ARM64.

Install on Omarchy

wayshare is in the Omarchy package repository:

omarchy pkg add wayshare

For 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.

Install script

curl -fsSL https://raw.githubusercontent.com/wesleygrimes/wayshare/main/install.sh | sh

Installs to ~/.local/bin. No sudo required.

Install with mise

If you use mise, run:

mise use -g github:wesleygrimes/wayshare

To build it yourself, see Build from source.

Set up

Run this in a terminal inside your Hyprland session:

wayshare setup

Choose 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.

Connect

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.

Commands

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

Upgrade

wayshare upgrade

Installs 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.

Uninstall

wayshare uninstall

Stops 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.

Documentation

Contributors

Thanks to these people (emoji key):

Wes Grimes
Wes Grimes

💻 📖 🚧
Andre Alves
Andre Alves

🐛 🤔 💻
Kit Knox
Kit Knox

💻 🐛 📓
kyler
kyler

💻 🐛
ernestodisa
ernestodisa

🐛 🤔
Snowy
Snowy

📓
Brandon Smith
Brandon Smith

💻
ChachizR
ChachizR

💻
3j27
3j27

💻 🐛 📦 ⚠️

This project follows the all-contributors specification. To contribute, see CONTRIBUTING.md.

Support

wayshare is free. If it's useful, you can sponsor the work or buy me a coffee.

License

Apache-2.0. See LICENSE.

About

Share your Hyprland desktop with a Mac's Screen Sharing app or RDP clients like Windows App and FreeRDP.

Topics

Resources

Contributing

Security policy

Stars

64 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages