Get Farhand

Put the host on the computer you want to reach, and the app on the device you'll use.

iPhone and iPad

The Farhand app: touch controls, the keyboard toolbar, and several computers at once. iOS 17 or later.

Any browser

Control your computers from any laptop, Chromebook or Android device, with a real keyboard and mouse. Included with Pro and Ultra.

  • Current Chrome, Edge, Safari or Firefox
  • Link the browser once with your iPhone

Farhand for Mac

A small menu-bar app that lets your iPhone and browser see and control this Mac. Signed and notarized by Apple.

  • Asks for Screen Recording and Accessibility, and shows you where
  • Starts at login and stays out of the way

Farhand for Windows

The Windows host runs in the background and starts at logon. Allow it through Windows Firewall on private networks when asked.

  • Windows 10 or 11
  • UAC prompts and the Ctrl+Alt+Del screen can't be controlled remotely (a Windows restriction)
  • Not code-signed yet, so SmartScreen may warn: choose More info, then Run anyway

Farhand for Linux

The Linux host runs in the background and starts when you log in. It shares X11 desktops, and Wayland desktops on GNOME and KDE Plasma. Install it with one command in a terminal:

curl -fsSL https://farhandapp.com/linux/install.sh | bash
  • Ubuntu 22.04, Debian 12, Fedora 38 or later, Arch, openSUSE and others with Python 3.10+
  • Installs for your user only, and offers to add any system packages it needs
  • On Wayland, approve the screen sharing dialog once and allow it to be remembered

Setting up

Install the host

Open it on the computer you want to reach (on Linux, run the install command) and grant the permissions it asks for. It shows a QR code.

Scan with your iPhone

In the Farhand app, tap + and scan the code. Signed in with Pro or Ultra, the computer also joins your account.

Link your browser

At farhandapp.com/app, sign in and choose Link this browser. Scan that code from Settings → Link a Browser in the app.

Setting up Farhand on Linux

1. Install

Sign in to your desktop (not over SSH), open a terminal and run:

curl -fsSL https://farhandapp.com/linux/install.sh | bash

The installer checks for what Farhand needs: Python 3.10 or later with its venv module, and on Wayland PyGObject and GStreamer's PipeWire plugin. If something's missing it shows the command for your distribution and offers to run it, which asks for your password. Everything else goes in your home folder (~/.local/share/farhand). Want to read the script first? Open farhandapp.com/linux/install.sh.

2. Allow screen sharing (Wayland only)

On a Wayland desktop, a system dialog asks to share your screen and allow remote control. Choose every screen you want to reach, allow the choice to be remembered, and share. Farhand only asks once. While a phone is connected, your desktop shows that the screen is being shared. On X11 there's nothing to approve.

3. Pair your iPhone

The installer shows a QR code. In the Farhand app, tap + and scan it. Signed in with Pro or Ultra, the computer also joins your account so you can reach it from anywhere. To pair another phone later, open ~/.farhand/pairing-qr.png.

Updating and removing

Run the install command again to update; your phones stay paired. To remove Farhand:

curl -fsSL https://farhandapp.com/linux/install.sh | bash -s -- --uninstall

That keeps the pairing key in ~/.farhand, so reinstalling keeps your phones paired. Add --purge to delete it too and remove the computer from your account. Use --no-autostart when installing if you'd rather start Farhand yourself.

Installing by hand

Download the .tar.gz, unpack it, and run host/run-host.sh from the folder inside. host/install-autostart-linux.sh starts it at login.

Good to know

  • Farhand runs as a user service: systemctl --user status farhand-host. Its log is ~/.farhand/host.log.
  • Clipboard sync needs wl-clipboard on Wayland or xclip on X11 (KDE Plasma works without either).
  • On Wayland, Farhand can't see where your own mouse is, so the phone shows where it last put the pointer.
  • Sway, Hyprland and other wlroots desktops don't offer remote control to apps yet. Log in to an X11 session there.
  • If GNOME or Plasma says screen sharing isn't available, restart the portal with systemctl --user restart xdg-desktop-portal, then systemctl --user restart farhand-host.