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 email@example.com.
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 firstname.lastname@example.org.
OCR doesn’t understand my language¶
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.
You can set the default language globally by setting
[ocr]section of .stbt.conf. For example:
[ocr] lang = eng+dan
To install additional languages, create the file
config/setup/setup in your
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 \ https://raw.githubusercontent.com/stb-tester/tessdata/d0a9de7/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.
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
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