TBS Agent

Software and firmware updates

Use TBS Agent to configure, update, and troubleshoot supported Team BlackSheep products. Start with Agent Web unless you specifically need the desktop installer or the radio-based Agent Lite tool.

Open Agent Web View downloads Troubleshooting

Choose your updater

Most pilots should start with Agent Web. Use Desktop when you need an installed tool, and Agent Lite when you want to configure supported devices directly from your radio.

Agent Web

Recommended for most users. Runs in Chrome and is always current.

  • Best for: Quick setup, configuration, and firmware updates
  • Runs on: Windows, macOS, Linux, and Android with Chrome
  • Needs: Chrome and a USB data cable
Open Agent Web

Agent Desktop

Installed desktop tool for users who prefer a local app or need desktop workflows.

  • Best for: Desktop setup and local update workflow
  • Runs on: Windows, macOS, and Linux
  • Needs: USB data cable and desktop installer
View desktop downloads

Agent Lite

Radio LUA tool for field configuration from supported radios.

  • Best for: Crossfire/Tracer configuration from the radio
  • Runs on: FreedomTX, OpenTX, EdgeTX, and Ethos radios
  • Needs: Radio SD card access or Ethos Suite
View Agent Lite downloads

Compatibility at a glance

Use this table to pick the right tool before reading install details.

Tool Best for Platform Firmware updates Notes
Agent Web Most product setup and updates Chrome on Windows, macOS, Linux, Android Yes on desktop Chrome. Mobile support is limited by browser/USB access. Always current because it runs from the web.
Agent Desktop Installed desktop workflow Windows, macOS, Linux Yes for supported devices Use when you want a local app or desktop-specific workflow.
Agent Lite Radio-side configuration in the field FreedomTX, OpenTX, EdgeTX, and Ethos radios No, treat it as a configuration tool rather than a full firmware updater. Choose the package for your radio operating system and install it on the radio SD card or through Ethos Suite.

Quick downloads

Use these direct links for the current Agent tools. Agent Web opens in the browser; Desktop and Lite packages download as ZIP files.

Before you troubleshoot

Most update problems are connection, browser, cable, or bootloader-state issues. Check these first.

  • Use a USB data cable, not a charge-only cable.
  • Use Chrome for Agent Web and allow the browser to access the USB device when prompted.
  • Try another USB port and disconnect other serial/USB tools that may hold the device open.
  • If the device is not detected, reboot it and check whether it needs to be placed into bootloader/update mode.
  • On Android, browser and USB support can vary by device. For firmware updates, a desktop computer is usually the safer path.
  • For Agent Lite, confirm the LUA files are copied to the correct radio SD card folder and that your radio firmware supports the script.

Advanced setup details

Use these details after you have chosen the right updater above.

Agent Web setup

Requirements

  • Chrome browser
  • USB data cable
  • Supported TBS device
  • Desktop computer for the most reliable firmware-update path

How to use it

  1. Open Agent Web.
  2. Connect the TBS device with a USB data cable.
  3. Allow Chrome to access the USB device when prompted.
  4. Select the product and follow the update or configuration flow.

Updating Agent Web

Agent Web updates automatically because it runs from the web. Reload the page if you suspect you are seeing stale browser state.

Agent Desktop setup

Requirements

  • Windows, macOS, or Linux desktop
  • USB data cable
  • Supported TBS device

How to use it

  1. Download the current ZIP for your operating system from Quick downloads.
  2. Install and open Agent Desktop.
  3. Connect the device with USB.
  4. Use the product screen to configure or update supported firmware.

Updating Agent Desktop

Use the update option inside the app or download the current ZIP for your operating system from Quick downloads.

Agent Lite setup

Requirements

  • FreedomTX, OpenTX, EdgeTX, or Ethos radio
  • Radio SD card access or Ethos Suite
  • Supported Crossfire or Tracer setup

Installation

  1. Download the package for your radio operating system from Quick downloads.
  2. Unpack the ZIP file.
  3. Copy the included files and folders to the radio SD card path shown in the package instructions, or open the ZIP in Ethos Suite for Ethos radios.
  4. Open the radio Tools menu and launch TBS Agent Lite.

Notes

Agent Lite is primarily for radio-side configuration. Use Agent Web or Agent Desktop for the most complete firmware-update workflow.