wayshare
Share your Hyprland desktop with your Mac.
Connect through the Mac's built-in Screen Sharing app. Nothing to install on macOS.
- Use your Hyprland and Omarchy shortcuts. Command sends Super.
- Copy and paste text, rich text, and images between machines.
- Use High Performance mode for low-latency video and sound.
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 script
curl -fsSL https://raw.githubusercontent.com/wesleygrimes/wayshare/main/install.sh | shInstalls 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.
Configure
Run this in a terminal inside your Hyprland session:
wayshare setup
Choose a password, the monitor to share, and the network to accept connections on. Setup saves your choices, starts wayshare, and displays the address and username for your Mac.
If ufw blocks the connection, setup offers to add a firewall rule using sudo.
Run wayshare setup again to change these choices. For
other settings, edit ~/.config/wayshare/config.toml, then run:
wayshare restart
Connect from your Mac
- Open Screen Sharing.
- Choose Connection → New and enter the address shown by setup.
- Sign in with the username shown by setup and the password you chose.
- Select High Performance when prompted.
For connection or startup problems, run wayshare doctor and see
Troubleshooting.
Documentation
- Configuration: display, keyboard, network, and other settings
- High Performance mode: encoders and audio requirements
- Security: encryption, ports, and VPN access
- Troubleshooting: connection problems, startup, and logs
- Packaging: install layout and dependencies
- Development: building and testing
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.
Uninstall
wayshare uninstall
Stops the service and removes wayshare. Keeps ~/.config/wayshare.
With mise, run wayshare uninstall before mise uninstall.
Contributors
Thanks to these people (emoji key):
 Wes Grimes 💻 📖 🚧 |
 Andre Alves 🐛 🤔 💻 |
 Kit Knox 💻 🐛 📓 |
 kyler 💻 🐛 |
 ernestodisa 🐛 🤔 |
 Snowy 📓 |
 Brandon Smith 💻 |
 ChachizR 💻 |
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.