Home / Articles / Troubleshooting
● Troubleshooting

Iriun won't connect? Try these fixes

The most common Iriun problems and the practical steps that resolve them, in the order worth trying.

Most Iriun issues come down to a handful of causes: the devices aren't on the same network, a permission is missing, or the video app loaded before the camera existed. Work through these in order.

Phone and computer won't connect

Confirm both devices are on the exact same Wi-Fi network — not a guest network, and not a setup where the router isolates devices from each other. If they still can't find each other, connect the phone by USB instead, which bypasses the network entirely.

Video is laggy or stutters

Lag is almost always a weak Wi-Fi signal. Move closer to the router, switch to USB, or lower the resolution in the desktop client's settings. A wired connection gives the most consistent results.

Iriun doesn't appear in Zoom, Teams or Meet

Start the Iriun desktop client first, then fully quit and reopen the video app so it detects the new camera. On macOS, also check that camera permission is granted in System Settings.

Black screen or frozen image

Close any other app that might be holding the camera, restart the Iriun phone app, and confirm the app has camera permission in your phone's settings. On Mac, verify both Iriun and the video app are enabled under Privacy & Security → Camera.

No microphone audio

The phone mic is selected separately from the camera. In your app's audio settings, choose Iriun as the microphone — or keep your existing mic if you prefer it. [PLACEHOLDER: confirm exact mic behaviour for the current version.]

Still stuck? The contact page has support details. When reporting an issue, note your OS, the app version, and whether you're on Wi-Fi or USB — it speeds things up.

Related