Handback

Help

Support

Email [email protected]. Setup steps are in the docs. Bug reports go to the same address — include the app version and what the Engine printed.

A sign-in didn't complete

Port busy: another sign-in on this device is already using the same callback port. Finish or delete that one, then try again.

Expired: the Engine waits 10 minutes for a sign-in's callback. After that, or after the machine disconnects, the window is closed.

Either way, re-tap the link to retry. For a login started outside Handback, see Recover a stuck login in the docs.

My iPhone misses links

iPhone and iPad receive only while Handback is on screen; iOS suspends it in the background. Links sent meanwhile wait on the machine for 24 hours and arrive when you open the app.

How do I re-pair a device?

In the app, delete the machine (machine settings → Delete Machine). On the machine, print the pairing QR again (on a Mac in Engine mode: Settings → Engine → Show pairing QR…), then scan it or paste the URI in the app (+ → Add Machine).

handback pair --host your-box:8765 --qr

Engine mode says the port is in use

Another Engine already holds port 8765 on this Mac — usually the command-line one, running as a service. In Settings → Engine, Import existing pairing… takes over its identity so your devices keep working; then stop it.

handback service uninstall

How do I stop handing back links on a Mac?

Turn off Settings → Engine → “Act as an engine on this Mac.” Handback gives the default browser back to the one you used before (macOS asks you to confirm) and stops the Engine. To keep the Engine but give the browser back, use Restore in the same pane; Pause sends every link to your own browser until you resume.

How do I remove the Engine?

Remove its service, then delete the handback binary and the handback-browser shim from ~/.local/bin, and remove the export BROWSER=… line from your shell profile if you added it. On Linux, also delete the handback.desktop entry (and pick another default browser if you made it the default).

On a headless Mac where you ran handback install --default-browser, also remove the helper app it made, then pick your browser again in System Settings → Desktop & Dock → Default web browser.

handback service uninstall
rm ~/.local/bin/handback ~/.local/bin/handback-browser

# Linux only:
rm ~/.local/share/applications/handback.desktop

# headless Mac with the default-browser helper only:
rm -rf ~/"Applications/Handback Helper.app"