Skip to main content

Sideloading Applications on TV Labs

TV Labs devices support sideloading applications through various methods. Whether you're an experienced developer or launching your application for the first time, this guide will walk you through sideloading your application onto a TV Labs device.

Overview:

  • ⏱️ Duration: ~2 minutes
  • 🎯 Audience: Anyone interested in sideloading applications on TV Labs devices
  • 🧠 Outcome: Understanding how to sideload applications using different methods available on TV Labs devices

Sideloading in Live Sessions

Drag-and-Drop Upload

The simplest method to sideload and immediately launch your application (without the need to install additional tools) is using the drag-and-drop build upload feature within a Live Session. After uploading and installing the build, your application will automatically launch on the device.

Drag-and-Drop Build Upload

Using tvlabs connect

The tvlabs connect CLI tool establishes a secure tunnel between your local machine and the device, enabling you to use locally installed vendor-specific tools for sideloading applications directly. For detailed instructions, see the CLI documentation.

Sideloading in Automation Sessions

important

Sideloading support for Automation sessions is available now but is actively evolving. Please contact support@tvlabs.ai to request features or ask questions.

To sideload an application through the Automation editor UI, provide the TV Labs build ID in the "Trace" or "Execute" menus. Upload your build to TV Labs using the tvlabs upload command, then copy and paste the resulting build ID into the appropriate field. The application will be sideloaded automatically when the session begins. Use the Open App automation step with your application ID to launch the app.

Automation Sideload

Sideloading in Appium Sessions

You can sideload builds during Appium sessions by specifying the tvlabs:build capability in your test configuration. Refer to the Appium documentation for more details.