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 only works if you are accessing the web portal from the same local network as the Stb-tester node. If you are accessing the Stb-tester portal from a different network, select JPEG thumbnails instead.

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 using pip install stb-tester. See IDE Configuration 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: