Help and troubleshooting

USB debugging is what lets Kopiro show and control the phone. It lives in the developer options, which are hidden by default.

1. Open Settings › About phone.
2. Tap Build number seven times. A message confirms developer options are on.
3. Open Developer options and turn on USB debugging.
4. Plug the phone back in and accept the prompt it shows.

The phone asks every computer for permission to use USB debugging. Until you accept, the screen stays out of reach.

1. Unlock the phone: the prompt never shows on a locked screen.
2. Tap Allow, and tick “Always allow” so it does not come back.
3. If nothing shows up, unplug and plug the cable back in, or try another USB port.

Windows recognises most phones on its own. Otherwise it is missing the manufacturer’s USB driver.

1. Install the manufacturer’s driver: Google USB Driver for Pixel, Samsung USB Driver for Galaxy.
2. Plug the phone back in, then check that it appears in Device Manager.
3. Try another cable: some cables only carry power, not data.

The iPhone only offers to trust a computer when it is unlocked and connected with a data cable.

1. Unlock the iPhone, then unplug and plug the cable back in.
2. If the prompt still does not show: Settings › General › Transfer or Reset › Reset › Reset Location & Privacy.
3. The first time an iPhone is shown, macOS also asks for camera access: accept it, the iPhone screen depends on it.

On Linux, access to the USB device has to be opened to your session by a udev rule. Kopiro shows the exact command in its connection assistant, and the download page repeats it.

1. Copy the udev rule from the download page and paste it into a terminal.
2. Unplug and plug the phone back in: the rule only applies from the next connection.

Over Wi-Fi the picture goes through your local network, so its quality depends entirely on it.

1. Put the phone and the computer on the same network, on 5 GHz if you can.
2. Avoid guest networks and access points that isolate devices from each other.
3. For a long session or precise work, plug the cable in: USB stays steadier.

A frozen picture almost always comes from the phone: it went to sleep, an app blocks screen capture, or the connection dropped.

1. Wake the phone and unlock it.
2. Some apps (banking, protected video) block screen capture: they show up black on purpose, it is not a fault.
3. Close the tile and open the device again to restart the session.

The key is activated in Settings › License. It is emailed to you at purchase.

1. Paste the whole key, with no space before or after.
2. A license activates on a limited number of computers: release one from Settings › License if you hit the limit.
3. Lost the key? Ask for it again from the “Resend my key” page.

An iPhone has to trust the computer before it lets its screen through, and only a Mac can display it. Work through these four points in order.

1. Unlock the iPhone, then tap “Trust” on the prompt that appears on the phone itself. It only appears when the device is unlocked.
2. Use a cable that carries data: many cables of unknown origin only charge.
3. Unplug the iPhone and plug it back in. If the prompt does not come back, open Settings › General › Transfer or Reset › Reset › Reset Location & Privacy, then plug it in again.
4. On macOS, allow Kopiro under System Settings › Privacy & Security › Camera, then restart the app.

Your licence covers 3 computers at a time. Moving to a new machine does not mean buying again: you just free up a slot.

1. On the old computer, open Settings › Licence and click “Deactivate this computer”. The slot is freed straight away.
2. On the new computer, install Kopiro, open Settings › Licence, and enter your key.
3. Lost your key? Ask for it again from the “Resend my key” page, using the email address you bought with.