> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/device-farm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/device-farm/manual.md).

# Manual Testing

Interactively test and debug mobile applications and web browsers in real time. Gesture, swipe, tap, type, inspect, and perform comprehensive testing on real hardware directly from your desktop browser.

> **Note:** You can enable **Element Explorer** during session setup or launch to inspect UI elements and generate Appium locators concurrently while performing manual tests.

***

### Prerequisites:

* Having a project created [(click here for more information on project creation)](/device-farm/project-creation-and-setup.md#creating-a-project)
* (Optional) Uploading an application binary file (`.apk`, `.ipa`, `.apks`, `.aab`) [(click here for more information on uploading an application)](/device-farm/project-creation-and-setup.md#application-management)

***

## Creating a Manual Device Session

1. **Navigate to Sessions:** Under **Projects**, click on the **“Sessions”** button on your target project card.

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-77d53db14717cd2ae1fa7ad2fb3ca8bfb41166a2%2FAspose.Words.a5ba35ee-3494-4720-8f8c-7cedbeae1812.013.png?alt=media)

2. **Click on “Mobile Session”:**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-afc26233a5dc9fd2c65a559ceea0fe956cf9c486%2Fmanual-new-mobile-session.png?alt=media)

3. **Choose and Filter Devices:**
   * Filter by **Platform** (`Android` or `iOS`).
   * Filter by **Region** (US, UK/EU, India) to ensure low-latency connectivity.
   * Filter by **Device Type** (Real Device or Cloud / AWS Device Farm).
   * Filter by **Brand** (Samsung, Apple, Google, OnePlus, Xiaomi, Huawei, etc.) or search by device model name.
   * Review device details on each card:
     * **CPU, RAM, Resolution, and OS Version**
     * **Dedicated vs Shared Device** indicator icons
     * **Availability Status:** `Available` (ready to test), `Busy` (in use), or `Maintenance`
     * **Device User Info:** For busy devices on Team or Enterprise tiers, hover/click the user icon to see who is currently using the device.

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-be3d8589b8bce1784526ddb9cbe9a264ba567349%2Fmanual-device-selection.png?alt=media)

4. **Configure Session Settings:**
   * **Session Name (Required):** Enter a descriptive name for your testing session.

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-b2109313cf3fcf9e8efcb893f869da88e8fc1246%2Fmanual-enter-session-name-device.png?alt=media)

* **Application File (Optional):** Choose an uploaded application binary from the dropdown. The app will be automatically installed when the session starts.

  > *Note:* You can also install or switch applications later inside an active session using the **In-Session App Installer**.

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-1797294622080676bbfed7188ee29f576152e5a2%2Fmanual-choose-application-to-test.png?alt=media)

* **Element Explorer Toggle:** Enable this toggle to start the session in Object Spy / Element Explorer mode for inspecting UI attributes and testing XPath locators.
* **Biometrics Bypass Toggle (Beta):** Enable this toggle to bypass fingerprint and Face ID prompts for instrumentable debug builds.
* **Reset App Toggle:** Automatically clear application user cache and data before starting.
* **Switch to Old Device Interface:** Toggle if you prefer the classic legacy single-pane view over the modern split-pane workspace.

5. **Click “Start Session”:**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-cdaa28f5a2ed474e513409b17627089b2315df77%2Fmanual-device-start-session.png?alt=media) ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-1e3a65d38deb7f0b90a2c4fddf06ba8104545394%2FInstalling-App.gif?alt=media)

***

## Workspace Layout

Device Farm provides a modern **Split-Pane Workspace** designed for maximum productivity:

* **Left Pane (Device Stream & Quick Controls):** Renders the ultra-responsive, low-latency WebRTC video stream of the physical device with touch interaction overlay and collapsible device control bar.
* **Right Pane (Metrics, Logs & Info):** Displays live device information (OS, CPU architecture, RAM, Resolution, Device UUID), real-time streaming **Device Logs**, and **Appium Logs**.
* **Split Resizing:** Drag the divider between panes to customize the view to your screen dimensions.

![Modern Split-Pane Device Session (iOS)](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-e30d186ef9ae9e7cb755d2fa6b1cc919f08754dc%2FIOS-device-with-logs.png?alt=media)

***

## Navigation & Control Bar

Next to the interactive device screen is a control bar providing hardware, software, and debugging controls.

### Device & Session Info:

The top of the session panel provides complete device specifications and runtime details:

![Session Info Card](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-32c46bb2d05f46b22230c2dc58705e4d5c4dcaa4%2Fsession-info.png?alt=media)

* **Session Name:** Name specified during test initiation.
* **Device Name & Region:** Device model and hosting data center location.
* **Hardware Specs:** OS Version, CPU Architecture, RAM, Resolution, and unique Device ID.

***

### Control Bar Actions:

* **Collapse / Expand Bar:** Click the chevron button to collapse the control bar into icon-only mode or expand it with full labels.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-825dfad87df2821f59ebfaea160e2e1568b9dc44%2Fdevice-sendKey-action.png?alt=media) **Send Keys / Clipboard:** Click **Send Keys** to open the clipboard text input modal. Type or paste long strings, URLs, or credentials and click *Send as Keys* to type them directly into the focused input field on the device.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-d3234945592a3b6d0814a53911b7a1b6587e690b%2Fdevice-keyboard-action.png?alt=media) **Capture Keyboard:** Toggle the physical keyboard capture. When enabled, keystrokes typed on your computer keyboard are sent directly to the remote device without using the on-screen soft keyboard.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-d2d077de6772314b6bee5046f8c2001064bec248%2Fdevice-ss-action.png?alt=media) **Screenshot:** Take an instant screenshot of the device display. Captured images are stored in the test report and can be downloaded immediately.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-90ef018c54a13392782cd3fdcd7f7cf10da20105%2Fdevice-rotate-action.png?alt=media) **Rotate Device (Orientation):** Click **Rotate** to toggle device orientation between Portrait and Landscape modes.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-754b4bfe1dd47ebcb48290f827e775903cb75c10%2Fdevice-fileUpload-action.png?alt=media) **File Upload:** Click **File Upload** to transfer files from your computer directly into the remote device storage (`Downloads` folder on Android; `Files > On My iPhone > Chrome` on iOS).
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-9b5683ab60a592d6166d2b401658e2c18ddc4c25%2Fdevice-installApp-action.png?alt=media) **In-Session App Installation:** Click **Install App** to open the in-session installer. Upload a new `.apk`, `.ipa`, `.apks`, or `.aab` file or choose an existing uploaded app to deploy onto the device on-the-fly without disconnecting.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-52bceb712b3b520954e1b20fa52aa2daaa1ad829%2Fdevice-createJiraTicket-action.png?alt=media) **Create Jira Ticket:** Click the **Jira** icon to open the integrated bug reporting modal. Select your Jira project, issue type (Bug, Task, Sub-task with Parent ID, or Xray test category), enter Summary & Description, choose Priority, and submit. The current device screenshot is automatically attached.
* **Phone Call & SMS Interrupts:** For telephony-enabled devices with an active SIM/number:
  * **Trigger Call:** Simulates an incoming voice call to verify how your app handles call interruptions.
  * **Trigger SMS:** Simulates an incoming text message notification.
* **Biometrics Bypass:** For supported apps, click the fingerprint icon to trigger biometric authentication bypass dynamically during testing.
* **Lock & Unlock Device:** Power off / lock the device screen, or wake / unlock the device (iOS & Android).
* **Volume Controls:** Hardware **Volume Up** and **Volume Down** buttons.
* **Hardware Navigation Buttons:**
  * **Back (`KEYCODE_BACK`):** Navigate back to the previous screen.
  * **Home (`KEYCODE_HOME`):** Return to the home screen.
  * **Overview / App Switcher (`KEYCODE_APP_SWITCH`):** Open the recent applications switcher (Android).
  * ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-363b89ad0355c9e5d91ddcfea7abcf6f72245853%2Fdevice-terminateApp-action.png?alt=media) **Terminate App:** Force terminate the currently running foreground application (iOS).
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-0d7146d8c9d5413265cad4dd077e4316e27513f2%2Fdevice-wifi-action.png?alt=media) **Network Shaping & Wi-Fi Selector:** Choose from preset network profiles (2G, 3G, 4G, Good, Poor) or custom profiles to simulate varying bandwidth, latency, and packet loss. You can also click *Add..* to configure and apply a new network profile on the fly.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-8d0ccda3542073bdeb24debb8b2a4326d49dac42%2Fdevice-videoResolution-action.png?alt=media) **Video Resolution Selector:** For WebRTC iOS sessions, choose your desired stream quality (e.g., `Auto`, `720p`, `1080p`).
* **Zoom Controls:** Use the **Zoom In (+)**, **Zoom Out (-)**, and **Reset Zoom** buttons to adjust device viewport scaling.
* **Disconnect Session:** Click the red power button to disconnect from the device. A confirmation modal will appear. Once confirmed, the session is cleanly released and the comprehensive test report is generated.

***

### **In-Session App Installation**

The in-session app installer allows testers to test multiple versions of an app or test app upgrades without losing the session connection.

1. Click **Install App** on the control bar.
2. In the dialog, you can:
   * **Upload New App:** Drag and drop or browse for a new `.apk`, `.ipa`, `.apks`, or `.aab` binary. The file will upload via fast multipart transfer.
   * **Choose Existing App:** Select any completed application from your project repository.
3. Click **Install** to deploy and launch the application on the remote device.

![In-Session App Installation Dialog](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-bce36c1521926e7e5059282d8c71a7d116b55ae0%2Fin-session-app-install.png?alt=media)

***

### **Device Logs**

Live logs stream system-level messages, application traces, and crash stack traces in real time from the moment the device connects.

Click on **`Show Logs`** to open the logs panel and **`Hide Logs`** to collapse it.

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-d0f495ec103284d718da1e2c92904bdf5dc4ed4d%2Fmanual-show-devicelogs.gif?alt=media)

![Device Logs Stream](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-b5c284e0c17f1ae5ca6524eaed0cd6f3ea2f17cc%2Fdevice-logs.png?alt=media)

#### Log Viewer Controls:

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-1b15104992d9f6abc048ae63c75961cfc58c58bd%2Fdevice-logs-btns.png?alt=media)

* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-f0d8e826681a26f00eb902aac3774b6e9df3d4bc%2Fclear-logs-btns.png?alt=media) **Clear Logs:** Clears the current log console buffer.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-813a7afc36e7d357f196333331520bb4a9a22cd4%2Fdevice-lock-btn.png?alt=media) **Pause / Lock Logs:** Pauses live log autoscroll so you can inspect a specific stack trace while the session continues.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-622d74fae1087f8f4e900dc6fd8a8f2a094bf2e4%2Frefresh-btn.png?alt=media) **Refresh Logs:** Refreshes log buffer from the device daemon.
* ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-0727dd05ac6d34570826b15edc9fde8d0c719d06%2Fdisconnect-btn.png?alt=media) **Disconnect Logs:** Pauses log stream to optimize network bandwidth.

***

### **Generate JSON Capabilities**

Click **Generate JSON** on the session interface to view and export the current session configuration, device UDID, and authentication payload formatted for Appium automation scripts.

![Generate JSON Payload](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-16da745dde5290c7fb669bb9a2371b1b4ff55600%2Fgenerate-json-ios.png?alt=media)

***

### **Network Shaping**

Network shaping allows you to simulate real-world mobile network conditions by adjusting bandwidth, latency (delay), and packet loss.

Select a preset network profile or choose a custom-created network profile by clicking on the Wi-Fi dropdown menu on the control bar. [Click here to view instructions on creating custom network profiles.](/device-farm/project-creation-and-setup.md#network-profiles-management)

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-8259484ca1a863b8cc830baf5c9f738d0f746f47%2Fmanual-network-shaping.gif?alt=media)

***

## Creating a Manual Browser Session

Device Farm enables real desktop browser testing across Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, and Samsung Internet.

1. **Under Projects, click on “Sessions” for your project**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-77d53db14717cd2ae1fa7ad2fb3ca8bfb41166a2%2FAspose.Words.a5ba35ee-3494-4720-8f8c-7cedbeae1812.013.png?alt=media)

2. **Click on “Web Browsers” tab**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-16858d0282cd7fde1dc0d5837cb38a8fefaf24a7%2Fclick-on-web-browser.png?alt=media)

3. **Click on “Browser Sessions”**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-1c6c4ae001c65531197cafe76b08ea3dfbbf218f%2Fclick-on-browser-sessions-btn.png?alt=media)

4. **Choose a browser from the list (Chrome, Firefox, Safari, Edge)**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-e209eb4e880da9435f98adad4f225ba26869eb6f%2Fselect-a-browser.png?alt=media)

5. **Enter a “Session Name” and click “Start Session”**

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-f0e0eadf0eee21a15961ebeae14d07447675f3b3%2Fenter-browser-session-name.png?alt=media) ![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-3689b50f3c8132ff626c64bec33872ec8284246c%2Fclick-on-start-session-btn.png?alt=media)

6. **Interacting with the Browser:**
   * Interact directly with web pages, test responsive breakpoints, and perform functional tests.
   * Use the draggable floating control widget to disconnect when done.
7. **End Session:** Click **Disconnect** to terminate the session and view the test execution report.

![](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-5b303eb8977a861048a638980b8c98fe381959fe%2FAspose.Words.a5ba35ee-3494-4720-8f8c-7cedbeae1812.031.png?alt=media)

***

### **Analyzing Test Results**

Once a manual test session is ended, review and analyze the detailed results:

* **Test Report:** Access the comprehensive test report containing full session video recording, device vitals graphs, device logs, screenshots, and metadata.\
  [**Click here to learn more about Test Reports and Analysis.**](/device-farm/test-reports-and-analysis.md)
* **Bug Reporting:** Document bugs directly from the report view or submit them to Jira ([Reporting Bugs](/device-farm/integrations.md#integrations-with-collaboration-tools)).

***