.. |br| raw:: html
.. _chromium-app:
Chromium Browser
================
You can integrate Chromium into your image to get a graphics-accelerated browser on your
NXP i.MX based module (i.MX8/i.MX9, e.g. QSXM/QSXP/TX8M/TX8P/QS93). Chromium runs on the
Wayland/Weston desktop and uses the GPU for rendering.
Build
-----
Set up your build-directory with these settings:
.. prompt::
:prompts: $
DISTRO=karo-xwayland MACHINE= source karo-setup-release.sh -b
Inside your build directory append this line to *conf/local.conf*:
.. code-block:: shell
CORE_IMAGE_EXTRA_INSTALL += "chromium-ozone-wayland"
Build the Weston image:
.. prompt::
:prompts: $
bitbake karo-image-weston
When your build has finished, flash your module with the image. See :doc:`/software-documentation/flashtools/uuu/index`.
Running Chromium
----------------
When booting your previously flashed module, Weston comes up.
Plug a USB hub into your baseboard's USB host port and insert keyboard, mouse and/or touchscreen.
Open the terminal (icon in the top-left corner), or connect via the terminal from your host computer.
The desktop comes up as user *root*, so you have to start Chromium with an extra argument.
On the target run:
.. prompt::
:prompts: #
chromium --no-sandbox