Install HandyPeer
HandyPeer runs on Windows 10 and 11, on Macs with Apple Silicon (M1 or newer) and on 64-bit Linux (Ubuntu 22.04 or newer, or a similar distribution). Both computers in a session need it installed. You don't need an account for the free plan.
Windows
- Download the installer from the home page.
- Run
HandyPeer-setup.exe. The installer is signed by HandyCafe, LLC. - For a short while after a new release, Windows SmartScreen may still ask you to confirm. Choose More info and then Run anyway.
macOS
- Download
HandyPeer.dmgfrom the home page. The app is notarized by Apple and opens without a warning. - Drag HandyPeer into the Applications folder and open it.
- The first time someone connects, macOS asks for permission to record the screen and to control the computer. Allow HandyPeer under System Settings > Privacy & Security, in Screen & System Audio Recording (called Screen Recording on older macOS) and Accessibility. Microphone access is asked for only when you talk in a session.
Linux
- Download from the home page. The AppImage runs on most distributions. The .deb package is for Ubuntu and Debian.
- AppImage: make the file executable with
chmod +x HandyPeer_*.AppImageand run it. The .deb package: install it withsudo apt install ./HandyPeer_*.deband open HandyPeer from the app menu. - To be viewed and controlled, the Linux computer must use an X11 (Xorg) session. Pick it on the login screen (on Ubuntu it is called Ubuntu on Xorg). In a Wayland session you can still connect to other computers, but nobody can see or control this one, and the app says so.
- On GNOME the tray icon needs the AppIndicator extension. Without a tray, closing the window quits HandyPeer.
Intel Macs are not supported yet.
The main window
- This device shows your 9-digit ID, written like 123-456-789. Give it to the person who will connect to you.
- Remote device is where you type someone else's ID to connect to them.
- Recent and History list the devices you connected to and every past session.
Next: connect to another computer.