wesleygrimes / wayshare

# 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 
https://github.com/user-attachments/assets/b43a3ae0-370d-4816-958b-87a16504bd8a
## Install
Install on your Hyprland machine. Requires Hyprland 0.56 or newer and systemd.
Builds are available for x86_64 and ARM64.
### Install script
 [code] 
Installs to `~/.local/bin`. No sudo required.
### Install with mise
If you use mise, run:
 [code] 
To build it yourself, see Build from source.
## Configure
Run this in a terminal inside your Hyprland session:
 [code] 
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:
 [code] 
## Connect from your Mac
1. Open **Screen Sharing**.
2. Choose **Connection → New** and enter the address shown by setup.
3. Sign in with the username shown by setup and the password you chose.
4. 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
 [code] 
Installs the latest release and restarts the service.
For version 0.1.5 or older, run the install command again, then `wayshare restart`.
### Uninstall
 [code] 
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.