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

  1. Install the necessary language pack (see instructions below). Since v30, the following language packs are already installed by default:

    • Danish (dan)
    • Dutch (nld)
    • English (eng)
    • French (fra)
    • German (deu)
    • Norwegian (nor)
    • Spanish (spa)

    Before v30, only English was installed by default.

  2. Use the lang parameter when you call stbt.ocr and stbt.match_text — for example stbt.ocr(lang="dan") or stbt.ocr(lang="eng+dan").

    You can set the default language globally by setting lang in the [ocr] section of .stbt.conf. For example:

    lang = eng+dan

To install additional languages, create the file config/setup/setup in your test-pack:

  • On v30 or newer, use the following contents:

    #!/bin/bash -ex
    # Install Japanese language support for OCR:
    sudo curl -o /usr/share/tesseract-ocr/4.00/tessdata/jpn.traineddata \
  • On v29 or earlier, use the following contents:

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

In both cases, change “jpn” to the three-letter ISO-639-3 language code that you want.

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