Connect to Desktop

Get the credential on the desktop

Open the UniClipboard desktop app on your computer and go to Devices, click the phone icon beside the invitation button, and keep Regular sync selected. On first use, confirm enabling it, then enter a device label and add the phone. The desktop shows a one-time credential (server address + username + password) and a QR code for adding this one phone.

• For how to enable phone sync on the desktop and what each field of the credential means, see Mobile Sync and Pairing & Sync.
• Your phone and computer need to be on the same Wi-Fi, or both on the same Tailscale / VPN. For access across networks, see Cross-network sync with Tailscale or Self-Hosted Server Node.

The plaintext password is usually shown only once. If the scan or entry doesn't go through, you can add the device again / rotate the password on the desktop to get a fresh one.

Option 1: Scan the QR code in the app (recommended)

Once the app is installed, choose Scan on the connect screen and point the camera at the QR code shown on the desktop.

• The first scan requires camera permission. In low light, turn on the flashlight from the screen.
• After a successful scan, the server address, username, and password are filled in automatically — just confirm and save.
• If the scan won't lock on, the camera is inconvenient, or the QR code isn't fully visible, choose Enter manually instead to switch to Option 2.

Option 2: Fill in the form manually

If scanning isn't convenient, type in the values from the desktop dialog by hand. Form fields:

Multiple fallback addresses let you reach the same desktop from different networks: LAN at home, Tailscale or a public gateway when you're out. Adding a few does no harm — the app picks a route automatically.

Test the connection and automatic address selection

Before saving, tap Test Connection to confirm the address and credentials are correct.

If you entered multiple fallback addresses, the app automatically picks the one that's reachable on your current network, and the screen marks which address "Will use" — you don't need to switch manually. It re-selects a route after you change networks.

If it can't connect, first check that the phone and computer are on the same Wi-Fi, that phone sync is enabled on the desktop, and that the address and port are correct. An authentication-failure message usually means the username or password is wrong (rotate the password on the desktop and re-enter it).

Connect multiple desktops / switch servers

You can save credentials for several desktops at once. To add another, just repeat the scan or manual flow above.

On the main screen, tap the current server name in the top bar to open the switcher panel, where you can switch between desktops, delete one, or scan to add a new one. All credentials are stored locally on the phone.