AWF - A widget factory (extended)

A widget factory is a theme preview application for GTK. It displays the various widget types provided by GTK in a single window allowing to see the visual effect of the applied theme.

Screenshots

GTK 2.24 (Pango 1.51)

GTK 3.24 (Pango 1.51)

GTK 4.12 (Pango 1.51)

Theme used for the screenshots is available here.

Tricks

• Some options are available from command line (read -h or man page).
• Options menu allow to display some standard dialogs.
• System and user themes menu allow to set current theme.
• Text direction menu allow to change text direction (LTR/RTL).
• Plus/minus toolbar buttons allow to show or hide: notebooks arrows, marks on progress bars and scales...
• Refresh toolbar button and refresh menu item allow to reload the current theme (like SIGHUP signal).
• Menu keyboard shortcuts can be updated on hover (GTK 2.24 and 3.x, gtk-can-change-accels).
• Notebooks tabs are scrollable (GTK 3.x and 4.x, gtk-scroll-tabs, like with GTK 2.24).
• With Ubuntu, menu keyboard shortcuts can also be updated on hover with: UBUNTU_MENUPROXY= awf-gtk3

Installation

It require GTK 2.24 or GTK 3.0+ (including 3.24) or GTK 4.0+ (including 4.12), and GLIB 2.28+.

Installation for Debian, Ubuntu, Trisquel, Linux Mint, MX Linux

• sudo apt install awf-gtk2 awf-gtk3 awf-gtk4

Installation for Fedora

• sudo dnf install awf-gtk2 awf-gtk3 awf-gtk4

Installation for openSUSE

• sudo zypper install awf-gtk2 awf-gtk3 awf-gtk4

Installation for Mageia

• sudo urpmi awf-gtk2 awf-gtk3 awf-gtk4

Building from source

• To compile the program with all major GTK versions available run: build.sh
• To compile the program and create DEB packages for Debian run: debian-gtkx/deb.sh
• To compile the program and create RPM packages for Fedora run: fedora/rpm-gtkx.sh
• To compile the program and create RPM packages for openSUSE run: opensuse/rpm-gtkx.sh
• To compile the program and create RPM packages for Mageia run: mageia/rpm-gtkx.sh

Alternative installation for Debian, Ubuntu, Trisquel, Linux Mint, MX Linux

# PPA: https://launchpad.net/~luigifab/+archive/ubuntu/packages
# with Debian 12+ you can use mantic+ instead of focal (https://unix.stackexchange.com/a/669008/364800)
# for Trisquel you can use focal for nabia, jammy for aramo
# for Linux Mint you can use focal for 20.x and 5, jammy for 21.x, noble for 22.x and 6
# for MX Linux you can use focal for 19.x and 21.x, noble for 23.x

sudo add-apt-repository ppa:luigifab/packages
sudo apt update
sudo apt install awf-gtk2 awf-gtk3 awf-gtk4
# or
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys FFE5BD439356DF7D
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install awf-gtk2 awf-gtk3 awf-gtk4
# or
sudo wget -O /etc/apt/trusted.gpg.d/luigifab.gpg https://www.luigifab.fr/apt.gpg
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install awf-gtk2 awf-gtk3 awf-gtk4

# sha256sum /etc/apt/trusted.gpg.d/luigifab.gpg
578c89a677048e38007462d543686b53587efba9f93814601169253c45ff9213
# apt-key list
/etc/apt/trusted.gpg.d/luigifab.gpg
pub   rsa4096 2020-10-31 [SC]
      458B 0C46 D024 FD8C B8BC  99CD FFE5 BD43 9356 DF7D

Dev

To reload theme when source files change, you can use Entr with the SIGHUP signal:

sudo apt install entr  or  sudo dnf install entr  or  sudo zypper install entr  or  ...
ls ~/.themes/yourtheme/gtk-3*/*.css | entr killall -s SIGHUP awf-gtk3

Copyright

• Current version: 2.8.0 (02/02/2024)
• Compatibility: GTK 2.24 / 3.0..3.24 / 4.0..4.12
• Links: luigifab.fr - github.com
  Arch Linux awf-gtk2.zst ; Arch Linux awf-gtk3.zst ; Arch Linux awf-gtk4.zst
  Debian awf-gtk3.deb, awf-gtk4.deb
  Fedora awf-gtk2.rpm ; Fedora awf-gtk3.rpm ; Fedora awf-gtk4.rpm
  openSUSE awf-gtk2.rpm ; openSUSE awf-gtk3.rpm ; openSUSE awf-gtk4.rpm
  Mageia awf-gtk2.rpm ; Mageia awf-gtk3.rpm ; Mageia awf-gtk4.rpm
  Trisquel awf-gtk3.deb, awf-gtk4.deb
  Ubuntu awf-gtk3.deb, awf-gtk4.deb
  Ubuntu PPA

This program is provided under the terms of the GNU GPLv3+ license.
If you like, take some of your time to improve the translations, go to https://bit.ly/2HyCCEc.

Packages in official distros repositories

Credits

Forked from awf by Valère Monseur (valr).