The wpesrc element is used to produce a video texture representing a web page rendered off-screen by WPE.

Starting from WPEBackend-FDO 1.6.x, software rendering support is available. This features allows wpesrc to be used on machines without GPU, and/or for testing purpose. To enable it, set the LIBGL_ALWAYS_SOFTWARE=true environment variable and make sure video/x-raw, format=BGRA caps are negotiated by the wpesrc element.

As the webview loading is usually not instantaneous, the wpesrc element emits messages indicating the load progress, in percent. The value is an estimate based on the total number of bytes expected to be received for a document, including all its possible subresources and child documents. The application can handle these element messages synchronously for instance, in order to display a progress bar or other visual load indicator. The load percent value is stored in the message structure as a double value named estimated-load-progress and the structure name is wpe-stats.

Example launch lines

gst-launch-1.0 -v wpesrc location="https://gstreamer.freedesktop.org" ! queue ! glimagesink

Shows the GStreamer website homepage

LIBGL_ALWAYS_SOFTWARE=true gst-launch-1.0 -v wpesrc num-buffers=50 location="https://gstreamer.freedesktop.org" \
  videoconvert ! pngenc ! multifilesink location=/tmp/snapshot-%05d.png

Saves the first 50 video frames generated for the GStreamer website as PNG files in /tmp.

gst-play-1.0 --videosink gtkglsink wpe://https://gstreamer.freedesktop.org

Shows the GStreamer website homepage as played with GstPlayer in a GTK+ window.

gst-launch-1.0  glvideomixer name=m sink_1::zorder=0 ! glimagesink wpesrc location="file:///tmp/asset.html" draw-background=0 \
  ! m. videotestsrc ! queue ! glupload ! glcolorconvert ! m.

Composite WPE with a video stream in a single OpenGL scene.

gst-launch-1.0 glvideomixer name=m sink_1::zorder=0 sink_0::height=818 sink_0::width=1920 ! gtkglsink \
   wpesrc location="file:///tmp/asset.html" draw-background=0 ! m.
   uridecodebin uri="http://example.com/Sintel.2010.1080p.mkv" name=d d. ! queue ! glupload ! glcolorconvert ! m.

Composite WPE with a video stream, sink_0 pad properties have to match the video dimensions.



Implemented interfaces

Factory details

Authors: – Philippe Normand , Žan Doberšek


Rank – none

Plugin – wpe

Package – gst-plugins-bad

Pad Templates


         format: RGBA
          width: [ 1, 2147483647 ]
         height: [ 1, 2147483647 ]
      framerate: [ 0/1, 2147483647/1 ]
pixel-aspect-ratio: 1/1
 texture-target: 2D
         format: BGRA



Object typeGstPad



configure_web_view_callback (GstElement * src,
                             GObject * webview,
                             gpointer udata)
def configure_web_view_callback (src, webview, udata):
    #python callback for the 'configure-web-view' signal
function configure_web_view_callback(src: GstElement * src, webview: GObject * webview, udata: gpointer udata): {
    // javascript callback for the 'configure-web-view' signal

Allow application to configure the webView settings.



the object which received the signal


the webView

No description available

Flags: Run Last

Action Signals


g_signal_emit_by_name (src, "load-bytes", bytes);
ret = src.emit ("load-bytes", bytes)
let ret = src.emit ("load-bytes", bytes);

Load the specified bytes into the internal webView.


src (GstElement *)

the object which received the signal

bytes (GBytes *)

the GBytes data to load

Flags: Run Last / Action



“draw-background” gboolean

Whether to draw the WebView background

Flags : Read / Write

Default value : true


“location” gchararray

The URL to display

Flags : Read / Write

Default value : NULL

The results of the search are