0xTsoa
←/

Materia

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

01. Overview & Architecture

Profile: v20210322
Schema validatedSource pinned
Purpose
Flat Material Design theme for GTK desktops.
Compatibility
Any distro (Server: BOTH)
Desktop Part
GTK & shell themes
Window Manager & Theme
Any WM / DE / Material

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/nana-4/materia-themePinned to d7f59a37ef51 · 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: materia-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/nana-4/materia-theme ~/0xtsoa-review/nana-4-materia-theme# 1. clone to a review folder
$git -C ~/0xtsoa-review/nana-4-materia-theme checkout --detach d7f59a37ef51f893c28b55dc344146e04b2cd52c# 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 materia-gtk-theme (Arch repos)
$sudo pacman -S --needed materia-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/nana-4/materia-theme/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 // Materia

Capture 01 // Fullscreen
widget-factory
01 / 12

04. Documentation & Guide

Source: nana-4/materia-themeRef: d7f59a37ef
README.md|GitHub Flavored Markdown
RawSource ↗
materia-logo

Materia

Materia is a Material Design theme for GNOME/GTK based desktop environments.

It supports GTK 2, GTK 3, GTK 4, GNOME Shell, Budgie, Cinnamon, MATE, Unity, Xfce, LightDM, GDM, Chrome theme, etc.

Previews

widget-factory widget-factory-dark

Features

Supports ripple animations for GTK 3 and 4:

ripple

3 color variants and 2 size variants are available:

Materia standard compact
standard Materia Materia-compact
dark Materia-dark Materia-dark-compact
light Materia-light Materia-light-compact

Supported Toolkits and Desktops

  • GTK 2
  • GTK 3 >=3.20
  • GTK 4 >=4.0
  • Budgie >=10.4
  • Cinnamon >=3.x
  • GNOME Shell >=3.26
  • MATE >=1.14
  • Unity >=7.4
  • Xfce >=4.13

Unsupported Apps and Desktops

  • elementary apps

    Because they are based on their own stylesheet that conflicts with GTK standards.

  • Downstream customized GNOME sessions

    E.g. "Ubuntu" session, "Pop" session. To properly use Materia on GNOME Shell, please install gnome-session and then switch to "GNOME" or "GNOME on Xorg" session from your display manager.

Installation

Distro Packages

Distro Package Name Annotation
Arch Linux materia-gtk-theme Link
Debian 10 or later materia-gtk-theme Link
Fedora materia-gtk-theme Link
Solus materia-gtk-theme Link
Ubuntu 18.04 or later materia-gtk-theme Link

NOTE: Distro packages could be outdated and incompatible with your desktop environment. You can check the latest version here.

Flatpak

All 6 variants are available via Flathub:

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install flathub org.gtk.Gtk3theme.Materia{,-dark,-light}{,-compact}

Manual Installation

See `INSTALL.md` for details.

Recommendations

Font

  • Use a font family including Medium weight (e.g. Roboto or M+) to properly display the theme.
  • Set the font size to 9.75 (= 13px at 96dpi) or 10.5 (= 14px at 96dpi).

Chrome Extensions

To improve the appearance of Chrome, you can install our Chrome extensions as follows:

  1. Open the /usr/share/themes/Materia<-variant>/chrome folder in your file manager.
  2. Drag and drop the .crx files into the Chrome's Extensions page (chrome://extensions).

GDM Theme

You can change the GDM (lock/login screen) theme by replacing the default GNOME Shell theme.
See `INSTALL_GDM_THEME.md` for details.

Customization

Materia can be customized with GUI application, **oomox theme designer**.

Materia also allows you to change the color scheme relatively easily in other ways. See `HACKING.md` for details.

Contributing

If you find bugs or have suggestions, please report it to the issue tracker. Any contribution would be much appreciated.

Todo list can be found at `TODO.md`.

Related Projects

License

Materia is distributed under the terms of the GNU General Public License, version 2 or later. See the `COPYING` file for details.

Acknowledgments

  • Materia is based on Adwaita by GNOME.
  • Design and specifications are based on Google's Material Design.
  • The included symbolic icons are based on Material Design icons by Google.
  • The Chrome scrollbar extension was forked from Adwaita-chrome-scrollbar by GNOME Integration Team.
  • Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with oomox.
  • @n3oxmind who helped improve the installation script we had.
  • @smurphos who made and provided the Cinnamon theme for Materia.
  • Our Meson code is heavily influenced by @monday15's lounge-gtk-theme.

Also thank you to all contributors and upstream developers.

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