0xTsoa
←/

adw-gtk3

▲ 0✓
01. Overview & Architecture02. Installation & Deployment03. Screenshot Gallery04. Documentation & Guide

01. Overview & Architecture

Profile: v6.5
Schema validatedSource pinned
Purpose
Brings the libadwaita look to legacy GTK3 applications.
Compatibility
Any distro (Server: BOTH)
Desktop Part
GTK & shell themes
Window Manager & Theme
Any WM / DE / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
Origingithub.com/lassekongo83/adw-gtk3Pinned to 47922ed96562 · reviewed in this config file
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: adw-gtk-theme
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/lassekongo83/adw-gtk3 ~/0xtsoa-review/lassekongo83-adw-gtk3# 1. clone to a review folder
$git -C ~/0xtsoa-review/lassekongo83-adw-gtk3 checkout --detach 47922ed96562c002696ad2d2d80383f2ad30dc93# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Install adw-gtk-theme (Arch repos)
$sudo pacman -S --needed adw-gtk-theme
$# Other distros: see the upstream README
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/lassekongo83/adw-gtk3/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // adw-gtk3

Capture 01 // Fullscreen
adw-gtk3-light
01 / 06

04. Documentation & Guide

Source: lassekongo83/adw-gtk3Ref: 47922ed965
README.md|GitHub Flavored Markdown
RawSource ↗

adw-gtk3

An unofficial GTK3 port of libadwaita.

This port does not claim to be a 100% look-a-like of libadwaita. There are some limitations to what GTK3 can do.

How To Use • Customization • Related Projects • Credits

Light theme Dark theme
adw-gtk3-light adw-gtk3-dark

Wallpapers: here and here

How to Use

Tarball Repository Flatpak Source Snap/Ubuntu
📦 Download ⬇️ See info below 📦 See info below 🔧 More information 📦 See info below

If you download the tarball, then extract the content of the file to: ~/.local/share/themes/

Repositories

On some distributions you can install the theme with the package manager.

Distribution Command/Info
Fedora dnf install adw-gtk3-theme
Arch pacman -S adw-gtk-theme
Manjaro pamac install adw-gtk3
Debian 3rd party repo

These are maintained by contributors.

Flatpak

Flatpak applications will not be styled unless you choose one of the installation options below.

  • Install themes from Flathub:
    • Does not work with non-libadwaita GTK4 apps.
flatpak install org.gtk.Gtk3theme.adw-gtk3 org.gtk.Gtk3theme.adw-gtk3-dark
  • Use flatpak override:
    • Works with non-libadwaita GTK4 apps if the theme is installed in ~/.local/share/themes
sudo flatpak override --filesystem=xdg-data/themes
sudo flatpak mask org.gtk.Gtk3theme.adw-gtk3
sudo flatpak mask org.gtk.Gtk3theme.adw-gtk3-dark

Snap

Snap apps only use themes that are provided by a theme Snap.

  • You can install the Snap version via the Snap Store or using this command:
sudo snap install gtk-theme-adw-gtk3

The official version of adw-gtk3 can be viewed by clicking the button below.

Get it from the Snap Store
How to activate the theme
  1. Install gnome-tweaks and set the theme under Appearance > Legacy Applications. For dark themes, adjust in gnome-control-center > Appearance.
  2. Optional: You can also use gsettings to switch themes:

Light theme:

gsettings set org.gnome.desktop.interface gtk-theme 'adw-gtk3' && gsettings set org.gnome.desktop.interface color-scheme 'default'

Dark theme:

gsettings set org.gnome.desktop.interface gtk-theme 'adw-gtk3-dark' && gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'

Revert to default:

gsettings set org.gnome.desktop.interface gtk-theme 'Adwaita' && gsettings set org.gnome.desktop.interface color-scheme 'default'

If for some reason the dark theme isn't applied to some GTK4 applications, try to add this to ~/.config/gtk-4.0/settings.ini:

[Settings]
gtk-application-prefer-dark-theme=1
gtk-theme-name=adw-gtk3-dark

And then relog.

Customization

Adw-gtk3 and libadwaita can be customized with GTK named colors. See adw-colors for more info.

If you want to change the accent color for most applications in GNOME 47 or later, you can use a small CLI program accent-color-changer.

adw-gtk3-customized

Wallpaper: here | Customization: Peninsula-dark

Related Projects

Credits

Special thanks to:

GitHub Flavored Markdown (github-markdown-css)README snapshot at 47922ed965