# Connecting to Your Kiwi Device

## Setup

Before using the Kiwi to manage the target computer, you must connect the Kiwi device to both your host computer and the target computer.

1. Connect your target device to the Kiwi:
   * Connect an HDMI cable from the target device to the Kiwi.
   * Connect a USB cable from the target device to the Kiwi.
2. Connect the Kiwi to your host computer:
   * Use a USB 3.0 cable to connect the Kiwi to your host computer.

{% hint style="info" %}
Make sure to use a USB 3.0 cable to connect the Kiwi device and the host computer, as USB 3.0 is necessary for the connection to work.
{% endhint %}

For users of **Ubuntu Linux 22.04**, there is a known conflict between product IDs used by a Braille screen reader and the USB to serial converter chip used in the Kiwi. To ensure the Cytrence Kiwi application can recognize the Kiwi device plugged in, you must run the following command to uninstall the "brltty" package. 

{% hint style="warning" %}
Unplug and plug in the Kiwi device after running the command.

```bash
sudo apt remove brltty
```

*Note: This step is not necessary for users of Ubuntu Linux 24.04.*
{% endhint %}

## Connect to Kiwi

1. Launch the Cytrence Kiwi application on your host computer.
2. When the Kiwi is detected, you'll see "A Kiwi is plugged in" in the bottom right corner.
3. Click the "Connect to Kiwi" button in the top left corner to establish a connection.

If the target computer is not powered on, you will see a black window.

<figure><img src="https://2733212895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNEFEOoeIgOR1hBTEoFAE%2Fuploads%2FymGG6lEb7ApdGbeGgWSr%2Fhome_screen.png?alt=media&#x26;token=4a516cf3-0bd5-4c07-ab18-691f40c941be" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
For **Windows** users, make sure the Cytrence Kiwi application has permission to use the camera. Check this permission by going to "Settings > Privacy & security > Camera". The "Camera access" setting must be active for the Cytrence Kiwi application to detect the connected Kiwi device.
{% endhint %}

{% hint style="warning" %}
For **macOS** users, when plugging a Kiwi into the host computer for the first time, allow the connection and grant access to the microphone and camera when prompted.
{% endhint %}

For **Ubuntu** 22.04, **Ubuntu** 24.04 and **Debian** 13 users experiencing the following permission error:

<figure><img src="https://2733212895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNEFEOoeIgOR1hBTEoFAE%2Fuploads%2FBV6WxbRxt85RSJ53SJOd%2Fserial_permission.png?alt=media&#x26;token=94f780af-216d-494c-a5c0-e1a71c03892c" alt=""><figcaption></figcaption></figure>

run the command below to resolve the permission issue.

{% hint style="warning" %}
Run this command, then restart the host computer:

```bash
sudo usermod -a -G dialout $USER
sudo reboot
```

{% endhint %}

## Troubleshooting

* Ensure all cables are securely connected.
* If the target device is not recognized, try disconnecting and reconnecting the cables.
* Restart the Kiwi application if you encounter any issues with the connection or display.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cytrence.gitbook.io/cytrence-kiwi-document/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.