---
title: "Live device sessions"
section: "Agent Pool & Device Farm"
description: "Use a mobile device live in SmartestQA: open a local device from Connected Devices or take a Device Farm device, tap and swipe, use system keys, install an app, and release the device."
url: https://docs.smartestqa.ai/en/agent-pool-live-device.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "live device use device live take device release screen mirroring stream tap swipe system keys back home recent apps rotate lock restart install app reconnect android ios h264 mjpeg"
---
# Agent Pool & Device Farm: Live device sessions

A live session streams a device’s screen to your browser and sends your clicks back as taps. Use it to explore an app, check a fix by hand, or prepare a device before a run.

## In short

**On this page you can**

- Open the screen of a phone or emulator attached to your own agent.
- Take a Device Farm device so nobody else and no run can use it meanwhile.
- Tap, swipe and use Back, Home, Recent Apps, volume, rotate and lock keys.
- Install a build from the App Library on a farm device.
- Release the device when you are done.

**How to use it**

1. Local device: Test Agents › Connected Devices › Use Device Live .
2. Farm device: Devices › Use device on an Available card › Take device .
3. Wait for the label to change from Preparing and Connecting to Live .
4. Click to tap, drag to swipe, and use System Keys .
5. Click Release or close the window to free the device.

## Two ways to go live

|  | Device on your agent | Device Farm device |
| --- | --- | --- |
| Where | **Test Agents** › **Connected Devices** › **Use Device Live** | **Devices** › **Use device** › **Take device** |
| Needs | A MOBILE project, your Localhost agent online, the device listed under Connected Devices | The Device Farm right, a device in state **Available** |
| Who | You, for devices on your own agent | [Admins](https://docs.smartestqa.ai/en/company-settings-roles.html) and on-premise users: any device of your company. Cloud users: devices assigned to your company |
| Holds the device | No; a running test can still use it | Yes; it shows **Busy** “In live use” and runs cannot take it |

## Open a device on your agent

1. **Find the device**

   In [**Test Agents**](https://docs.smartestqa.ai/en/agent-pool-agents.html#agent-list), under [**Connected Devices**](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#connected-devices), find the phone or emulator. If the list is empty, see [Connected Devices](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#connected-devices).
2. **Click Use Device Live**

   The button on the device row opens a window titled with the agent name and the platform.

   The status goes from **Preparing** to **Connecting** to **Live**, and the screen appears.

## Take a Device Farm device

1. **Open the device**

   In **Devices**, filter for **Available** and click [**Use device**](https://docs.smartestqa.ai/en/agent-pool-devices.html#device-details) on a card. The device view opens with an empty frame: “Take the device to mirror its screen and send input.”
2. **Take it**

   Click **Take device**.

   The screen appears in the frame, the holder line says “You have this device” and the card shows **Busy** to everyone else.
3. **Work on it**

   Tap, swipe and use the keys (below). The expand button in the frame’s toolbar makes the phone bigger without restarting the stream.
4. **Release it**

   Click **Release**, or close the device view.

   The device returns to **Available**.

> **Note: If your browser crashes**
>
> The device is held for you on a lease of 180 seconds that renews while the stream is open. If the browser or network dies, the device frees itself at the latest about three minutes later. [Admins](https://docs.smartestqa.ai/en/company-settings-roles.html) can free it at once with [Force release](https://docs.smartestqa.ai/en/agent-pool-devices.html#device-controls).

## What you can do in a session

- **Click** to tap, **click and drag** to swipe. Typing on your keyboard is not passed to the device yet; use the on-screen keyboard of the device.
- ****System Keys****: **Back**, **Home**, **Recent Apps**, **Volume Up**, **Volume Down**, **Rotate**, **Lock Screen / Wake**. They become active when the stream is ready (“Will be active when stream is ready.”).
- ****Restart**** on a device of your agent reboots it after “Reboot device?” (“The live stream will be lost.”). The window shows “Restarting device…”; when the device is back, click **Reconnect**. On farm devices, admins restart from the [device controls](https://docs.smartestqa.ai/en/agent-pool-devices.html#device-controls) next to the keys.
- **[**Install App**](https://docs.smartestqa.ai/en/agent-pool-app-library.html#install-on-devices)** under the phone of a farm device (admins and on-premise users) installs a build from the [App Library](https://docs.smartestqa.ai/en/agent-pool-app-library.html), whether or not you have taken the device.
- ****Full screen**** enlarges the window of a device on your agent; on farm devices the expand button in the frame toolbar does the same.
- The footer shows the stream **Codec**: `h264` or `webrtc` for Android, `mjpeg` for iOS.

| Platform | Watch | Control |
| --- | --- | --- |
| Android phone or emulator | Yes | Taps, swipes, system keys, restart |
| iOS device or simulator (agent or node on a Mac) | Yes | Not yet: “iOS control will be active in Phase 4 (Mac agent required).” Restart is disabled. |

## When the connection drops

The window shows its state at the top: **Preparing**, **Connecting**, **Live**, “Reconnecting… (*n*/3)”, **Connection failed**, **Error** or **Closed**.

- If the first connection takes too long, or the stream breaks, the window retries by itself up to three times with growing pauses. The exact timings are in [Live session timings](https://docs.smartestqa.ai/en/agent-pool-numbers.html#live-timeouts).
- After the third failed retry you see “Connection failed” with “The device stream could not be started. The device may be busy with a running test or temporarily unreachable. Try reconnecting.” and a **Try Again** button.
- Permission errors (for example “This device is not available to your company.”) are not retried; they would only fail again.

## Rules that apply

- A farm device must be **Available**. A Busy or Offline device cannot be taken.
- In the cloud service, live control works on devices assigned to your company. Shared devices are used by runs only.
- The usage mode (Automation, Manual, Dual use) does not block a live session; it only keeps automatic runs off Manual devices.

## If something goes wrong

- [“Connection failed” or “Could not start stream”](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-live-connect-failed)
- [The device cannot be taken (busy, not available, needs a reservation)](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-live-not-available)
- [I can see an iOS device but not control it](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-ios-no-control)
- [The device stays Busy after I closed the window](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-device-stuck-busy)
- [“This codec is not supported yet”](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-codec)
