My Stb-tester HDMI 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

Install the stb-tester Python package into a venv using python setup. See IDE Integration for more details.

If your IDE still can’t find the stbt APIs, make sure that you installed stb-tester into the same Python environment that your IDE is using. For example, if you have a virtualenv under the .venv folder in your test-pack checkout, make sure that you activated that virtualenv before running pip install stb-tester.

If you’re using PyCharm you can configure the project’s Python interpreter in File > Settings > Project > Project Interpreter. In the screenshot below we have configured it to use Python from the project’s .venv folder: