Files
clapper/README.md
Rafostar edcc7b71b9 Add meson build system (#1)
Initial meson build system support. We do not create .desktop file yet, but we need an option to open media files from GUI first anyway.
2020-09-08 19:55:59 +02:00

1.8 KiB

Clapper

A GNOME media player built using GJS and powered by GStreamer with OpenGL rendering. Can also be used as a pre-made widget for GTK apps.

WORK IN PROGRESS

This is still early WIP. Many features are not implemented yet and quite a few are still unstable. Right now Clapper can only play single file. So if you want to test it, start it from terminal like this:

com.github.rafostar.Clapper "video.mp4"

Requirements

Clapper uses GStreamer bindings from GI repository, so if your repo ships them as separate package, they must be installed first. Additionally Clapper requires these GStreamer elements:

Other required plugins (codecs) depend on video format.

Installation

Run in terminal:

meson builddir --prefix=/usr/local
sudo meson install -C builddir

Hardware acceleration

Using hardware acceleration is highly recommended. As stated in GStreamer wiki:

In the case of OpenGL based elements, the buffers have the GstVideoGLTextureUploadMeta meta, which
efficiently copies the content of the VA-API surface into a GL texture.

Clapper uses OpenGL based sinks, so when VA-API is available, both CPU and RAM usage is much lower.

To use VA-API make sure you have gstreamer1-vaapi installed. Verify with:

gst-inspect-1.0 vaapi

On some older GPUs you might need to export GST_VAAPI_ALL_DRIVERS=1 environment variable.

Other acceleration methods (supported by GStreamer) should also work, but I have not tested them due to lack of hardware.