Skip to content
forked from valr/awf

New features for A Widget Factory for GTK 2.24, 3.x, 4.x, 5.x.

License

Notifications You must be signed in to change notification settings

luigifab/awf-extended

 
 

Repository files navigation

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)
Preview with GTK 2 - Main window Preview with GTK 2 - Menu Preview with GTK 2 - RTL - Main window Preview with GTK 2 - RTL - Menu

GTK 3.24 (Pango 1.51)
Preview with GTK 3 - Main window Preview with GTK 3 - Menu Preview with GTK 3 - RTL - Main window Preview with GTK 3 - RTL - Menu

GTK 4.12 (Pango 1.51)
Preview with GTK 4 - Main window Preview with GTK 4 - Menu Preview with GTK 4 - RTL - Main window Preview with GTK 4 - RTL - Menu

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

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

Packages status

Credits

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