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

  1. Download the installer from the home page.
  2. Run HandyPeer-setup.exe. The installer is signed by HandyCafe, LLC.
  3. For a short while after a new release, Windows SmartScreen may still ask you to confirm. Choose More info and then Run anyway.

macOS

  1. Download HandyPeer.dmg from the home page. The app is notarized by Apple and opens without a warning.
  2. Drag HandyPeer into the Applications folder and open it.
  3. 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

  1. Download from the home page. The AppImage runs on most distributions. The .deb package is for Ubuntu and Debian.
  2. AppImage: make the file executable with chmod +x HandyPeer_*.AppImage and run it. The .deb package: install it with sudo apt install ./HandyPeer_*.deb and open HandyPeer from the app menu.
  3. 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.
  4. 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.