Release Notes for Emulator

Version added 28-Jun-2018| Modified 20-Aug-2018

webOS Open Source Edition (OSE) emulator is an x86 (x86_64) virtualization system based on QEMU virtualizer. Currently, the emulator only supports Linux Ubuntu as a host operating system.

Refer to the following for detailed information of each release.


webOS OSE Emulator Initial Release (June 2018)

System Requirements

Note that this version of emulator is optimized for the following host environment.

  • Operating system

    • Linux Ubuntu

      • 16.04 (32-bit and 64-bit)

      • 14.04 (32-bit and 64-bit)

      • 18.04 (64-bit) (not fully tested)

  • Processor: Intel® Pentium® 4 2.0 GHz or faster

  • Memory: 3 GB or more RAM

  • Display: 1920 x 1080 or higher screen resolution

  • Graphics card: 256 MB or more video memory with OpenGL 3.0 support

  • Required software

    • qemu 2.7.0 or higher version

    • virglrenderer 0.6.0 or higher version (0.6.0 tag version is recommended)

    • libsdl2-2.0-0 or higher version

    • OpenGL 3.0 or higher version

New Features

  • QEMU x86 virtual machine based emulator

  • Provides graphics performance with host PC's GPU H/W acceleration

  • Emulates major features of webOS OSE platform on PC without RPi3 target device

  • Provides emulator run script with JSON configuration file for easy use

  • Supports webOS OSE CLI tool for application and platform development

Known Issues

  • Flickering occurs when playing some WebGL content such as

  • Displayed text is not clear when you change the size of the QEMU windows to low resolution.


If you got the error "qemu_gl_create_compile_shader: compile vertex error: GLSL ES 3.00 is not supported. ..." when you run the emulator, the OpenGL/Mesa of your host PC doesn't support OpenGL 3.0.

So please refer to the following steps.

Step 1. Check the installed Mesa package.

$ sudo apt list --installed | grep mesa

Step 2. Check the OpenGL & Mesa library version.

$ glxinfo | grep "OpenGL version"

Step 3. Delete old Mesa package.

Step 4. Update the system.

$ sudo apt-get update
$ sudo apt-get upgrade (or sudo apt-get dist-upgrade)
$ sudo apt-get -f install

Step 5. Install newest Mesa package.

$ sudo apt-get install -f libegl1-mesa-lts-xenial

Step 6. Install dependency packages.

$ sudo apt-get install libegl1-mesa-drivers
$ sudo apt-get install epoxy0
$ sudo apt-get install libsdl2-2.0-0

Except as noted, this content is licensed under Creative Commons Attribution 4.0 and sample code is licensed under Apache License 2.0.