exported SGML document, ASCII text
![](img src="images/materia-logo.svg" alt="materia-logo" align="right" /){kind=link}
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
Features
Supports ripple animations for GTK 3 and 4:
3 color variants and 2 size variants are available:
Materia | standard | compact :-: | :-: | :-: standard | ![Materia][1] | ![Materia-compact][2] dark | ![Materia-dark][3] | ![Materia-dark-compact][4] light | ![Materia-light][5] | ![Materia-light-compact][6]
[1]: images/Materia.png?raw=true [2]: images/Materia-compact.png?raw=true [3]: images/Materia-dark.png?raw=true [4]: images/Materia-dark-compact.png?raw=true [5]: images/Materia-light.png?raw=true [6]: images/Materia-light-compact.png?raw=true
Supported Toolkits and Desktops
GTK 2
GTK 3
>=3.20GTK 4
>=4.0Budgie
>=10.4Cinnamon
>=3.xGNOME Shell
>=3.26MATE
>=1.14Unity
>=7.4Xfce
>=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-sessionand 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.
Warning for Ubuntu 19.04 & 19.10 users: Ubuntu 19.04 (disco) & 19.10 (eoan) packages are very outdated and incompatible with their GNOME versions. If you're using GNOME on Ubuntu 19.04 or 19.10, manual installation is highly recommended.
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) or10.5(= 14px at 96dpi).
Chrome Extensions
To improve the appearance of Chrome, you can install our Chrome extensions as follows:
Open the
/usr/share/themes/Materia<-variant>/chromefolder in your file manager.Drag and drop the
.crxfiles 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 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
Materia KDE by @PapirusDevelopmentTeam
Materia VSCode Theme by @m-thorsen
Materia Kolorizer by @DarthWound
oomox theme designer by @themix-project
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.
@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.
1
<img src="images/materia-logo.svg" alt="materia-logo" align="right" />
2
# Materia
4
Materia is a [Material Design](https://material.io) theme for GNOME/GTK based desktop environments.
6
It supports GTK 2, GTK 3, GTK 4, GNOME Shell, Budgie, Cinnamon, MATE, Unity, Xfce, LightDM, GDM, Chrome theme, etc.
8
## Previews
10
12
13
## Features
15
Supports **ripple animations** for GTK 3 and 4:
17
19
**3 color variants** and **2 size variants** are available:
21
**Materia** | **standard** | **compact**
23
:-: | :-: | :-:
24
**standard** | ![Materia][1] | ![Materia-compact][2]
25
**dark** | ![Materia-dark][3] | ![Materia-dark-compact][4]
26
**light** | ![Materia-light][5] | ![Materia-light-compact][6]
27
[1]: images/Materia.png?raw=true
29
[2]: images/Materia-compact.png?raw=true
30
[3]: images/Materia-dark.png?raw=true
31
[4]: images/Materia-dark-compact.png?raw=true
32
[5]: images/Materia-light.png?raw=true
33
[6]: images/Materia-light-compact.png?raw=true
34
## Supported Toolkits and Desktops
36
- GTK 2
38
- GTK 3 `>=3.20`
39
- GTK 4 `>=4.0`
40
- Budgie `>=10.4`
41
- Cinnamon `>=3.x`
42
- GNOME Shell `>=3.26`
43
- MATE `>=1.14`
44
- Unity `>=7.4`
45
- Xfce `>=4.13`
46
## Unsupported Apps and Desktops
48
- elementary apps
50
> Because they are based on [their own stylesheet](https://github.com/elementary/stylesheet) that conflicts with GTK standards.
51
- Downstream customized GNOME sessions
52
> 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.
53
## Installation
55
### Distro Packages
57
<!-- For contributors, please add your package alphabetically. -->
59
Distro | Package Name | Annotation
61
--- | --- | ---
62
Arch Linux | `materia-gtk-theme` | [Link](https://www.archlinux.org/packages/community/any/materia-gtk-theme/)
63
Debian 10 or later | `materia-gtk-theme` | [Link](https://packages.debian.org/materia-gtk-theme)
64
Fedora | `materia-gtk-theme` | [Link](https://src.fedoraproject.org/rpms/materia-gtk-theme)
65
Solus | `materia-gtk-theme` | [Link](https://dev.getsol.us/source/materia-gtk-theme/)
66
Ubuntu 18.04 or later | `materia-gtk-theme` | [Link](https://packages.ubuntu.com/materia-gtk-theme)
67
> NOTE: Distro packages could be outdated and incompatible with your desktop environment. You can check the latest version [here](https://github.com/nana-4/materia-theme/releases).
69
> **Warning for Ubuntu 19.04 & 19.10 users:** Ubuntu 19.04 (disco) & 19.10 (eoan) packages are very outdated and incompatible with their GNOME versions. If you're using GNOME on Ubuntu 19.04 or 19.10, [manual installation](#manual-installation) is highly recommended.
71
### Flatpak
73
All 6 variants are available via Flathub:
75
```
77
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
78
flatpak install flathub org.gtk.Gtk3theme.Materia{,-dark,-light}{,-compact}
79
```
80
### Manual Installation
82
See [`INSTALL.md`](INSTALL.md) for details.
84
## Recommendations
86
### Font
88
- Use a font family including **Medium** weight (e.g. [Roboto](https://github.com/google/roboto) or [M+](https://mplus-fonts.osdn.jp)) to properly display the theme.
90
- Set the font size to `9.75` (= 13px at 96dpi) or `10.5` (= 14px at 96dpi).
91
### Chrome Extensions
93
To improve the appearance of Chrome, you can install our Chrome extensions as follows:
95
1. Open the `/usr/share/themes/Materia<-variant>/chrome` folder in your file manager.
97
2. Drag and drop the `.crx` files into the Chrome's Extensions page (`chrome://extensions`).
98
### GDM Theme
100
You can change the GDM (lock/login screen) theme by replacing the default GNOME Shell theme.
102
See [`gnome-shell/README.md`](src/gnome-shell/README.md) for details.
103
## Customization
105
Materia can be customized with GUI application, [**oomox theme designer**](https://github.com/themix-project/oomox).
107
Materia also allows you to change the color scheme relatively easily in other ways. See [`HACKING.md`](HACKING.md#how-to-change-the-color-scheme) for details.
109
## Contributing
111
If you find bugs or have suggestions, please report it to the [issue tracker](https://github.com/nana-4/materia-theme/issues). Any contribution would be much appreciated.
113
Todo list can be found at [`TODO.md`](TODO.md).
115
## Related Projects
117
- [**Materia KDE**](https://github.com/PapirusDevelopmentTeam/materia-kde) by @PapirusDevelopmentTeam
119
- [**Materia VSCode Theme**](https://marketplace.visualstudio.com/items?itemName=m-thorsen.vscode-materia) by @m-thorsen
120
- [**Materia Kolorizer**](https://github.com/DarthWound/materia-kolorizer) by @DarthWound
121
- [**oomox theme designer**](https://github.com/themix-project/oomox) by @themix-project
122
## License
124
Materia is distributed under the terms of the GNU General Public License, version 2 or later. See the [`COPYING`](COPYING) file for details.
126
## Acknowledgments
128
- Materia is based on [Adwaita](HACKING.md#upstream-theme-sources) by GNOME.
130
- Design and specifications are based on Google's [Material Design](https://material.io).
131
- The included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
132
- The Chrome scrollbar extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.
133
- Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with [oomox](https://github.com/themix-project/oomox).
134
- @n3oxmind who helped improve the installation script.
135
- @smurphos who made and provided the Cinnamon theme for Materia.
136
- Our Meson code is heavily influenced by @monday15's [lounge-gtk-theme](https://github.com/monday15/lounge-gtk-theme).
137
Also thank you to all contributors and upstream developers.
139