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

OCR doesn’t understand my language

  • Install the necessary language pack by creating the file config/setup/setup with the following contents:

    #!/bin/bash -ex
    # Install Danish language support for OCR:
    sudo DEBIAN_FRONTEND=noninteractive apt-get install -y tesseract-ocr-dan

    …where “dan” is a three-letter ISO-639-3 language code.

    For more information about the config/setup/setup script see Customising the test-run environment.

  • Use the lang parameter when you call stbt.ocr and stbt.match_text —for example stbt.ocr(lang="dan")— or set the default language globally by setting lang in the [ocr] section of .stbt.conf.