Introduction to Cheese

Cheese is used to take photos and videos with fun graphical effects.



Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

Cheese Dependencies


clutter-gst-3.0.27, clutter-gtk-1.8.4, gnome-desktop-44.0, gst-plugins-bad-1.22.6, gst-plugins-good-1.22.6 (built with v4l-utils-1.24.1), libcanberra-0.30, and libgudev-238



GTK-Doc-1.33.2, libxslt-1.1.38, appstream-glib, LCOV , and Nautilus SendTo

Kernel Configuration

Depending on your camera, enable the appropriate options and recompile the kernel if necessary:

Device Drivers --->
  <*/M> Multimedia support --->                                  [MEDIA_SUPPORT]
    [*] Autoselect ancillary drivers (tuners, sensors, i2c, spi, frontends)
                                                  ...  [MEDIA_SUBDRV_AUTOSELECT]
    Media device types --->
      [*] Cameras and video grabbers                      [MEDIA_CAMERA_SUPPORT]
    Media drivers --->
      [ /*] Media USB Adapters --->                          [MEDIA_USB_SUPPORT]
        # Most modern USB camera needs this.
        # For other devices you need to figure it out yourself:
        < /*/M> USB Video Class (UVC)                          [USB_VIDEO_CLASS]

Installation of Cheese

Install Cheese by running the following commands:

mkdir build &&
cd    build &&

meson setup --prefix=/usr        \
            --buildtype=release  \
            -Dgtk_doc=false      \
            -Dtests=true         \
            ..                   &&

To test the results, issue: ninja test

Now, as the root user:

ninja install

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Dgtk_doc=false: This switch prevents the build system from generating and installing the API documentation. Omit this switch if you have GTK-Doc-1.33.2 installed and wish to generate and install the API documentation. Building the documentation is broken due to an incompatibility with gtk-doc.

-Dtests=true: This switch allows building the tests so that the test suite can be run. Remove this switch if you are not going to run the tests.


Installed Program: cheese
Installed Library: and
Installed Directories: /usr/{include,share/gtk-doc/html,share/help/*}/cheese

Short Descriptions


is a webcam tool with graphical effects

contains the Cheese API functions

contains the Cheese GTK+ widgets