%general-entities; ]> $Date$ GTK->k4-version; GTK-4 Introduction to GTK 4 The GTK 4 package contains libraries used for creating graphical user interfaces for applications. &lfs101_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: >k4-md5sum; Download size: >k4-size; Estimated disk space required: >k4-buildsize; Estimated build time: >k4-time; GTK 4 Dependencies Required , , , , , , , , Recommended (default for some gtk4 settings keys), , , (needed for tests and for defaults), and Recommended (Required if building GNOME) Optional , , , (runtime, only used by gtk4-demo for syntax highlighting of demo source code), , , , , gi-docgen, libcloudproviders, and vulkan User Notes: Installation of GTK 4 Install GTK 4 by running the following commands: mkdir build && cd build && meson --prefix=/usr -Dbroadway_backend=true .. && ninja Running the test suite is not recommended unless you are in a Wayland session. If you are not in a Wayland session, around 625 tests will fail. Under a Wayland session, the number decreases to around 25. If you are in a Wayland session and wish to run the tests, issue: ninja test. Now, as the root user: ninja install Command Explanations -Dbroadway_backend=true: This switch enables the HTML5 GDK backend. : Use this switch if you have libcloudproviders installed and wish to enable support for cloud providers in a file chooser window. : Use this switch if you have installed and wish to enable tracing support for GTK4-based applications. : Use this switch if you have installed and wish to use search functionality when running a file chooser. : Use this switch if you have installed and wish to use colord with the CUPS printing backend. : Use this switch if you have installed and wish to rebuild the themes. : Use this switch if you have installed and wish to generate the API reference documentation. Configuring GTK 4 Config Files ~/.config/gtk-4.0/settings.ini and /usr/share/gtk-4.0/settings.ini ~/.config/gtk-4.0/settings.ini /usr/share/gtk-4.0/settings.ini Configuration Information GTK 4 themes change the way a GTK 4 application looks. An icon theme can be used to change the icons that appear on the application's toolbar. If you have installed a GTK 4 theme (e.g. the Adwaita theme built in GTK 4), an icon theme (such as ) and/or a font (), you can set your preferences in ~/.config/gtk-4.0/settings.ini, or the default system-wide configuration file (as the root user), in /usr/share/gtk-4.0/settings.ini. For the local user, an example is: mkdir -pv ~/.config/gtk-4.0 cat > ~/.config/gtk-4.0/settings.ini << "EOF" [Settings] gtk-theme-name = Adwaita gtk-icon-theme-name = oxygen gtk-font-name = DejaVu Sans 12 gtk-cutsor-theme-size = 18 gtk-xft-antialias = 1 gtk-xft-hinting = 1 gtk-xft-hintstyle = hintslight gtk-xft-rgba = rgb gtk-cursor-theme-name = Adwaita EOF There are many settings keys, some with default values. You can find them at Settings: GTK 4 Reference Manual. Contents Installed Programs Installed Libraries Installed Directories gtk4-broadwayd, gtk4-builder-tool, gtk4-demo, gtk4-demo-application, gtk4-encode-symbolic-svg, gtk4-icon-browser, gtk4-launch, gtk4-print-editor, gtk4-query-settings, gtk4-update-icon-cache, and gtk4-widget-factory libgtk-4.so /usr/include/gtk-4.0, /usr/lib/gtk-4.0, and /usr/share/gtk-4.0 Short Descriptions gtk4-broadwayd provides support for displaying GTK 4 applications in a web browser using HTML5 and web sockets gtk4-broadwayd gtk4-builder-tool performs various operations on GtkBuilder .ui files gtk4-builder-tool gtk4-demo is a simple program that demonstrates some of the tasks that can be done with GTK 4 gtk4-demo gtk4-demo-application is a simple GTK 4 application which is useful for testing gtk4-demo-application gtk4-encode-symbolic-svg converts symbolic SVG icons into special PNG files. GTK 4 can load and recolor these PNGs, just like original SVGs, but loading them is much faster gtk4-encode-symbolic-svg gtk4-icon-browser is a utility to explore the icons in the current icon theme. It shows icons in various sizes, their symbolic variants when available, as well as a description of the icon and its context gtk4-icon-browser gtk4-launch launches an application using the given name. The name should match the application .desktop file name (as seen in /usr/share/applications), with or without the '.desktop' extension gtk4-launch gtk4-print-editor is a simple program to demonstrate printing using GTK 4 applications gtk4-print-editor gtk4-query-settings provides a complete listing of all settings related to GTK 4 gtk4-query-settings gtk4-update-icon-cache is an icon theme caching utility that creates mmap()able cache files for icon themes gtk4-update-icon-cache gtk4-widget-factory is a program to view GTK 4 themes and widgets gtk4-widget-factory libgtk-4.so contains functions that provide an API to implement graphical user interfaces libgtk-4.so