My Stb-tester node is offline#


The Stb-tester node must be able to access the Stb-tester web portal over the internet using HTTPS port 443. Make sure that your network configuration isn’t preventing this.

Diagnostic information about your network connectivity can be obtained by plugging a monitor into the Stb-tester node’s HDMI output. If you need further assistance, take a photo of the diagnostic screen and send it to


Live video doesn’t play in the web portal#

The live video uses WebRTC which is a peer-to-peer technology (the peers are: The Stb-tester Node, and your browser). This only works if the 2 peers can establish a direct connection with each other. Some networks (routers, NATs, firewalls) can block this connection. If the WebRTC live video isn’t working for you, select “JPEG thumbnails” from the video-formats menu — see Live video formats for more details.

The set-top box intermittently ignores infrared keypresses#

  • Check the position of stb-tester’s infrared transmitter. This is a low-power transmitter (to avoid interfering with other set-top boxes in your test lab) so it has to be close against the set-top box’s IR receiver.

    Some set-top boxes are very sensitive to the placement of the transmitter; for example this image shows a set-top box that has a cylindrical shield extending around the IR receiver diode, so Stb-tester’s IR transmitter must be placed precisely in front of the diode:

    Using a torch (flashlight) can help you to see the position of the IR receiver behind the set-top box’s plastic case.

  • If you’re still seeing issues, send us your infrared configuration file to

My IDE can’t find the stbt APIs#

Follow the instructions in Development Environment Setup to install the stbt APIs and configure your IDE.