How to install a simple web browser

Warning white.png Important
The simple web browser, subject of this article, is not part of STM32MPU ecosystem releases, for which ST provides some support.
This article only provides, as example, some helper guidelines (tips): you may need to make some adaptations depending on your system setup.

A simple web browser, based on Qt5, can be easily installed using the package repository for OpenSTLinux distribution service.

2 solutions exist:

  • Qt® application
  • Qt® Python™ application

1 qt-wpe-simple-browser[edit]

1.1 Installation[edit]

Board $> apt-get update
Board $> apt-get install qt-wpe-simple-browser

1.2 Usage[edit]

Board $> qt-wpe-simple-browser <url http://>

2 python3-pyqt5[edit]

2.1 Installation[edit]

Board $> apt-get update
Board $> apt-get install python3-pyqt5

Create the script:

# Copyright (c) STMicroelectronics
# License: BSD-3-Clause
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *
from PyQt5.QtGui import *
from PyQt5.QtWebKitWidgets import *

import sys

class MainWindow(QMainWindow):

    def __init__(self, *args, **kwargs):
        super(MainWindow,self).__init__(*args, **kwargs)

        self.browser = QWebView()
        self.browser.setUrl( QUrl(sys.argv[1]) )

app = QApplication(sys.argv)
window = MainWindow()

2.2 Usage[edit]

Board $> python3  <url http://>

3 Display platform[edit]

Two solutions exist to display the web browser:

  • using eglfs
  • using Wayland

3.1 wayland[edit]

  • Weston must be started. If you have stopped it, you can restart Weston with the following command
Board $> systemctl start weston@root
  • Install qtwayland
Board $> apt-get install qtwayland
  • Set Wayland egl as display platform
Board $> export QT_QPA_PLATFORM=wayland-egl
  • And set the following variable
Board $> export QML2_IMPORT_PATH='/usr/lib/qt5/qml/'
  • Launch the Python web browser
Board $> qt-wpe-simple-browser <url http://>


Board $> python3  <url http://> --qwindowgeometry <width>x<height>

3.2 eglfs[edit]

  • Stop the Weston application
Board $> systemctl stop weston@root
  • Set eglfs as display platform
Board $> export QT_QPA_PLATFORM=eglfs
  • And set the following variables
Board $> export QML2_IMPORT_PATH='/usr/lib/qt5/qml/'
Board $> export QT_QPA_EGLFS_ALWAYS_SET_MODE='1'
  • Launch the web browser
Board $> qt-wpe-simple-browser <url http://>


Board $> python3  <url http://>
Info white.png Information
With HDMI connection, it is advised to use the following kms eglfs_config.json config file in order to avoid cursor rendering issue.
  "device": "/dev/dri/card0",
  "hwcursor": false,
  "pbuffers": true,
  "outputs": [
      "name": "HDMI1",
      "mode": "1280x720"

Set Qt variable to use the json config file:

Board $> export QT_QPA_EGLFS_KMS_CONFIG='/home/root/eglfs_config.json'