Skip to content

Latest commit

 

History

History
155 lines (105 loc) · 5.56 KB

README.md

File metadata and controls

155 lines (105 loc) · 5.56 KB
Raw

materia-logo

Materia

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

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

Preview

widget-factory

Features

Ripple effect animations for GTK 3 are supported:

Button

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

Various desktop environments are supported:

  • GNOME Shell >=3.18
  • Budgie >=10.4
  • Cinnamon >=3.x
  • MATE >=1.14
  • Unity >=7.4
  • Xfce >=4.13

Requirements

  • GTK >=3.20
  • gnome-themes-extra (or gnome-themes-standard)
  • Murrine engine — The package name depends on the distro.
    • gtk-engine-murrine on Arch Linux
    • gtk-murrine-engine on Fedora
    • gtk2-engine-murrine on openSUSE
    • gtk2-engines-murrine on Debian, Ubuntu, etc.
  • bc — build dependency

Installation

Distro Packages

Distro Package Name / Link
Arch Linux materia-gtk-theme
Debian testing / unstable
Ubuntu 18.04+		 materia-gtk-theme
Ubuntu 16.04 / 17.10 materia-gtk-theme from @igor-dyatlov's PPA
Fedora materia-theme from @LaurentTreguier's Copr
Solus materia-gtk-theme

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

Run the following commands in the terminal:

git clone --depth 1 https://github.com/nana-4/materia-theme
cd materia-theme
sudo ./install.sh

Tip: ./install.sh allows the following options:

-d, --dest DIR          Specify destination directory (Default: /usr/share/themes)
-n, --name NAME         Specify theme name (Default: Materia)
-c, --color VARIANT...  Specify color variant(s) [standard|dark|light] (Default: All variants)
-s, --size VARIANT      Specify size variant [standard|compact] (Default: All variants)
-g, --gdm               Install and apply GDM theme (for advanced users)
-h, --help              Show help

Manual Uninstallation

Delete the installed directories:

sudo rm -rf /usr/share/themes/Materia{,-dark,-light}{,-compact}

Recommendations

Font

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

Chrome Theme

To use the Chrome theme;

  1. Open the chrome folder on /usr/share/themes/Materia<-variant>.
  2. Drag and drop the .crx files into the Chrome/Chromium Extensions page (chrome://extensions).

GDM Theme

You can change the GDM (lock/login screen) theme by replacing the default GNOME Shell theme.
See gnome-shell/README.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.

Credits

  • 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.
  • Chrome/Chromium scrollbars 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.
  • @smurphos who made and provided the Cinnamon theme for Materia.

Also thank you to all contributors and upstream developers.