A fork of the Materia GTK theme.

Important information: Google announced that, from September 2026, Android devices will require ALL apps to be signed by Google, effectively leading to an iOS situation. Value your right to a computer that does what you want; do not tolerate this monopolistic practice! Contact me if you don't understand why it is bad. Click to learn more.

 README.md

View raw Download
text/plain • 5.89 kiB
Unicode text, UTF-8 text

Materia

widget-factory

Materia (formerly Flat-Plat) is a Material Design theme for GNOME/GTK+ based desktop environments. It supports GTK+ 3, GTK+ 2, GNOME Shell, Budgie, Cinnamon, MATE, Unity, LightDM, GDM, Chrome theme, etc.

Also Materia has compatibility with oomox theme designer.

Features

Ripple effect animations for GTK+ 3 are supported:

Button

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

Various desktop environments are supported:

  • GNOME Shell >=3.18

  • Budgie >=10.2.5

  • Cinnamon >=3.x

  • MATE >=1.14

  • Unity >=7.4

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

Packages

| Distro | Maintainer | Install Command | | : | : | :-- | | Arch Linux [[Official][Arch]] | @ArchangeGabriel | sudo pacman -S materia-gtk-theme | | Debian 10 / sid [[Official][Debian]] Ubuntu 18.04+ | @isaagar | sudo apt install materia-gtk-theme | | Ubuntu 16.04 / 17.10 [[PPA][PPA]] | @igor-dyatlov | sudo add-apt-repository ppa:dyatlov-igor/materia-theme sudo apt update sudo apt install materia-gtk-theme | | Fedora [[Copr][Copr]] | @LaurentTreguier | sudo dnf copr enable tcg/themes sudo dnf install materia-theme |

[Arch]: https://www.archlinux.org/packages/community/any/materia-gtk-theme [Debian]: https://packages.debian.org/unstable/materia-gtk-theme [PPA]: https://launchpad.net/~dyatlov-igor/+archive/ubuntu/materia-theme [Copr]: https://copr.fedorainfracloud.org/coprs/tcg/themes

Flatpak

3 variants (Materia, Materia-dark, Materia-light) 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
flatpak install flathub org.gtk.Gtk3theme.Materia-dark
flatpak install flathub org.gtk.Gtk3theme.Materia-light

Manual Installation

Run the following commands in the terminal:

cd /tmp && wget -qO - https://github.com/nana-4/materia-theme/archive/master.tar.gz | tar xz
cd materia-theme-master
sudo ./install.sh

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

-d, --dest DIR           Specify destination directory
-n, --name NAME          Specify theme name
-c, --color VARIANTS...  Specify color variant(s) [standard|dark|light]
-s, --size VARIANT       Specify size variant [standard|compact]

Without any options, Materia will be installed with all variants into /usr/share/themes. Try ./install.sh --help for more information.

Manual Uninstallation

Delete the installed directories:

sudo rm -rf /usr/share/themes/Materia{,-compact,-dark,-dark-compact,-light,-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 the wiki for details: https://github.com/nana-4/materia-theme/wiki/GDM-Theme

Customization

Materia allows you to change the color scheme relatively easily. 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 here: 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.

                
                    
1
# Materia
2
3
![widget-factory](../images/widget-factory.png?raw=true)
4
5
Materia (formerly Flat-Plat) is a [Material Design](https://material.io) theme for GNOME/GTK+ based desktop environments.
6
It supports GTK+ 3, GTK+ 2, GNOME Shell, Budgie, Cinnamon, MATE, Unity, LightDM, GDM, Chrome theme, etc.
7
8
Also Materia has compatibility with [oomox theme designer](https://github.com/themix-project/oomox).
9
10
## Features
11
12
**Ripple effect** animations for GTK+ 3 are supported:
13
14
![Button](../images/Button.gif?raw=true)
15
16
**3 color variants** and **2 size variants** are available:
17
18
| **Materia** | **standard** | **compact** |
19
| :-: | :-: | :-: |
20
| **standard** | ![Materia][1] | ![Materia-compact][2] |
21
| **dark** | ![Materia-dark][3] | ![Materia-dark-compact][4] |
22
| **light** | ![Materia-light][5] | ![Materia-light-compact][6] |
23
24
[1]: ../images/Materia.png?raw=true
25
[2]: ../images/Materia-compact.png?raw=true
26
[3]: ../images/Materia-dark.png?raw=true
27
[4]: ../images/Materia-dark-compact.png?raw=true
28
[5]: ../images/Materia-light.png?raw=true
29
[6]: ../images/Materia-light-compact.png?raw=true
30
31
Various **desktop environments** are supported:
32
33
- GNOME Shell `>=3.18`
34
- Budgie `>=10.2.5`
35
- Cinnamon `>=3.x`
36
- MATE `>=1.14`
37
- Unity `>=7.4`
38
39
## Requirements
40
41
- GTK+ `>=3.20`
42
- `gnome-themes-extra` (or `gnome-themes-standard`)
43
- Murrine engine — The package name depends on the distro.
44
- `gtk-engine-murrine` on Arch Linux
45
- `gtk-murrine-engine` on Fedora
46
- `gtk2-engine-murrine` on openSUSE
47
- `gtk2-engines-murrine` on Debian, Ubuntu, etc.
48
- `bc` — build dependency
49
50
## Installation
51
52
### Packages
53
54
| Distro | Maintainer | Install Command |
55
| :-- | :-- | :-- |
56
| Arch Linux <sup>[[Official][Arch]]</sup> | @ArchangeGabriel | `sudo pacman -S materia-gtk-theme` |
57
| Debian 10 / sid <sup>[[Official][Debian]]</sup> <br> Ubuntu 18.04+ | @isaagar | `sudo apt install materia-gtk-theme` |
58
| Ubuntu 16.04 / 17.10 <sup>[[PPA][PPA]]</sup> | @igor-dyatlov | `sudo add-apt-repository ppa:dyatlov-igor/materia-theme` <br> `sudo apt update` <br> `sudo apt install materia-gtk-theme` |
59
| Fedora <sup>[[Copr][Copr]]</sup> | @LaurentTreguier | `sudo dnf copr enable tcg/themes` <br> `sudo dnf install materia-theme` |
60
61
[Arch]: https://www.archlinux.org/packages/community/any/materia-gtk-theme
62
[Debian]: https://packages.debian.org/unstable/materia-gtk-theme
63
[PPA]: https://launchpad.net/~dyatlov-igor/+archive/ubuntu/materia-theme
64
[Copr]: https://copr.fedorainfracloud.org/coprs/tcg/themes
65
66
#### Flatpak
67
68
3 variants (Materia, Materia-dark, Materia-light) are available via Flathub:
69
70
```
71
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
72
flatpak install flathub org.gtk.Gtk3theme.Materia
73
flatpak install flathub org.gtk.Gtk3theme.Materia-dark
74
flatpak install flathub org.gtk.Gtk3theme.Materia-light
75
```
76
77
### Manual Installation
78
79
Run the following commands in the terminal:
80
81
```sh
82
cd /tmp && wget -qO - https://github.com/nana-4/materia-theme/archive/master.tar.gz | tar xz
83
cd materia-theme-master
84
sudo ./install.sh
85
```
86
87
Note: `./install.sh` allows the following options:
88
89
```
90
-d, --dest DIR Specify destination directory
91
-n, --name NAME Specify theme name
92
-c, --color VARIANTS... Specify color variant(s) [standard|dark|light]
93
-s, --size VARIANT Specify size variant [standard|compact]
94
```
95
96
Without any options, Materia will be installed with all variants into `/usr/share/themes`.
97
Try `./install.sh --help` for more information.
98
99
### Manual Uninstallation
100
101
Delete the installed directories:
102
103
```sh
104
sudo rm -rf /usr/share/themes/Materia{,-compact,-dark,-dark-compact,-light,-light-compact}
105
```
106
107
## Recommendations
108
109
#### Font
110
111
- To properly display the theme, use a font family including **Medium** weight (e.g. [Roboto](https://github.com/google/roboto) or [M+](https://mplus-fonts.osdn.jp)).
112
- Set the font size to `9.75` or `10.5` (i.e. 13px or 14px at 96dpi).
113
114
#### Chrome Theme
115
116
To use the Chrome theme;
117
118
1. Open the `chrome` folder on `/usr/share/themes/Materia<-variant>`.
119
2. Drag and drop the `.crx` files into the Chrome/Chromium Extensions page (`chrome://extensions`).
120
121
#### GDM Theme
122
123
You can change the GDM (lock/login screen) theme by replacing the default GNOME Shell theme.
124
See the wiki for details: https://github.com/nana-4/materia-theme/wiki/GDM-Theme
125
126
## Customization
127
128
Materia allows you to change the color scheme relatively easily. See [`HACKING.md`](HACKING.md#how-to-change-the-color-scheme) for details.
129
130
## Contributing
131
132
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.
133
134
ToDo list can be found here: [`TODO.md`](TODO.md)
135
136
## Related Projects
137
138
- [**Materia KDE**](https://github.com/PapirusDevelopmentTeam/materia-kde) by @PapirusDevelopmentTeam
139
- [**Materia VSCode Theme**](https://marketplace.visualstudio.com/items?itemName=m-thorsen.vscode-material-mt) by @m-thorsen
140
- [**Materia Kolorizer**](https://github.com/DarthWound/materia-kolorizer) by @DarthWound
141
142
## License
143
144
Materia is distributed under the terms of the GNU General Public License, version 2 or later. See the [`COPYING`](COPYING) file for details.
145
146
## Credits
147
148
- Materia is based on [Adwaita](HACKING.md#upstream-theme-sources) by GNOME.
149
- Design and specifications are based on Google's [Material Design](https://material.io).
150
- The included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
151
- Chrome/Chromium scrollbars extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.
152
- Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with [oomox](https://github.com/themix-project/oomox).
153
- @n3oxmind who helped improve the installation script.
154
- @smurphos who made and provided the Cinnamon theme for Materia.
155
156
Also thank you to all contributors and upstream developers.
157