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.

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.

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.

Unplug and plug in the Kiwi device after running the command.

sudo apt remove brltty

Note: This step is not necessary for users of Ubuntu Linux 24.04.

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.

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.

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.

For Ubuntu Linux 22.04 and 24.04 users experiencing the following permission error:

run the command below to resolve the permission issue.

Run this command, then restart the host computer:

sudo usermod -a -G dialout $USER
sudo reboot

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.

Last updated