Roku Client Builds

This topic shows you how to:

  • update the Roku client manifest file for local testing
  • create a zip file of the Roku client files
  • load the zip file onto your Roku device as a side-channel

You can prepare for local testing through the client build script or manually.

Prepare Your Device

  1. Connect your Roku device to the same network as your development computer.
  2. Put your Roku into developer mode. Take note of your Roku device’s IP address and developer password; you’ll need these below.

Option 1: Run the ‘youi-tv roku-client’ CLI command

Run the following command from your Roku client app folder:

youi-tv roku-client -u rokudev:<roku_password> -l -s <roku_IP_address>

You can see a full list of the youi-tv roku-client command options by using youi-tv roku-client -h.

Option 2: Manually Prepare for Local Testing

To manually prepare your device for local testing:

  1. Open the manifest file in your client folder:

    Navigate to Manifest file in your client folder

  2. Update the manifest file to allow for local testing:

    1. Add a host entry with a value of the IP address of your app development platform. The Roku device and your app development platform should be on the same IP subnet. For example, if the Roku device has an IP address of, your app development platform might have an IP address of

    2. Add a port entry with a value of 54322.

      Where to add port and host values

    3. Save and close the file.

  3. Zip the client directory to create a new file containing the updated manifest file. Use the following command, not a GUI utility. From within the extracted client directory, enter:

    zip -r .

  4. Using the Roku device’s IP address, start a browser session on the Roku device.

    Start a browser session on the Roku Device screen

  5. If the Roku device already has an app, click Delete to remove it.
  6. Click Upload and select the file.

    The file name is displayed beside the Upload button.

  7. Click Replace.

    The Roku device installs client software with the new manifest file and launches the app. If the app has never been built yet, the attempt launch fails.

    What a successful installation looks like