Troubleshooting

"A direct connection could not be made"

HandyPeer connects the two computers directly whenever it can. Some networks block that: strict company firewalls, some mobile carriers (carrier-grade NAT) and networks that block UDP. This happens on a very small share of networks.

If either side has a Pro or Team plan, HandyPeer switches to its relay server after a few seconds and you won't see this message. The session stays end-to-end encrypted. The viewer's top bar shows a Relayed badge. The Free and Personal plans have no relay. On these networks they get this message.

What helps:

  • Try another network on one side, such as a home connection or a phone hotspot.
  • Ask the network's administrator whether outgoing UDP is blocked.
  • Use a Pro or Team plan on either side. Those sessions fall back to the encrypted relay.

"The remote device is offline or the ID is wrong"

Check the 9 digits. The other computer must have HandyPeer open and show "Ready for connections". If they recently took a New ID, the old one no longer works.

"Cannot reach the HandyPeer server"

Your computer can't reach the server that hands out IDs. Check the internet connection and any firewall or proxy. In Settings, the Server field should hold the default address unless your company runs its own server.

"The versions do not match. Update HandyPeer."

Both sides need a current version. Download the latest from the home page.

"This device's identity changed since your last connection"

The ID belongs to a different device key than the one you connected to before. It can happen when HandyPeer's settings were deleted on the other side. It can also mean someone is trying to pose as that device. Confirm with the person by phone before you trust it again.

The other side says no

  • "The other side rejected the connection" or "did not answer": ask them to watch for the request.
  • "The other side rejected you a moment ago. Try again in a minute." A rejected device waits 60 seconds.
  • "Too many attempts. Wait a moment and try again." Requests are slowed down after many tries.

Passwords

  • "Wrong password": check the unattended-access password, it is case sensitive.
  • "Too many wrong passwords. Try again in a minute." Wait, then try once more.

Limits

  • "The free session ended after 10 minutes": connect again or use a paid plan on either side.
  • "Today's 60 free minutes are used up": the limit resets the next day.
  • "Your plan is in use on as many devices as it allows": remove a device on the account page.

Picture and sound

  • "This system cannot decode the video stream": update the operating system and graphics drivers. On Linux, also install the gstreamer1.0-libav package.
  • The remote screen shows a notice when it is locked or asleep. The picture returns when it wakes.
  • The remote computer runs Linux and its screen never shows: it must use an X11 (Xorg) session, not Wayland. HandyPeer on that computer shows the same notice.
  • "Sound is not available from this device": remote sound comes from Windows computers, and from Linux computers that have a monitor input device. On Linux, add pcm.monitor { type pulse; device "@DEFAULT_MONITOR@"; hint { show on; description "Monitor" } } to ~/.asoundrc and restart HandyPeer.
  • "The microphone could not be opened": pick a microphone in Settings and check that HandyPeer has microphone permission in your system settings.

Still stuck? Write to info@handypeer.com with the exact message and both systems.