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.67 kiB
ASCII text

Materia

Materia (formerly Flat-Plat) is a Material Design theme for GNOME/GTK+ based desktop environments. It supports GTK+ 3, GTK+ 2, GNOME Shell, Budgie, 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

Three color variants and two size variants are available:

| Materia | - | compact | |:-:|:-:|:-:| | - | 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.2.5

  • MATE >=1.14

  • Unity >=7.4

  • ... and more DEs are planned.

Requirements

  • GTK+ >=3.18

  • 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.

  • glib-compile-resources - The package name depends on the distro.

    • glib2 on Arch Linux

    • glib2-devel on Fedora, openSUSE, etc.

    • libglib2.0-dev on Debian, Ubuntu, etc.

For Ubuntu, you'll also need the libxml2-utils package.

Installation

Packages

|| Install command | |:-|:-| | Arch Linux [1] | yaourt -S materia-theme | | Fedora / EPEL [2] | sudo dnf copr enable tcg/themes && sudo dnf install materia-theme | | Ubuntu [3] | sudo add-apt-repository ppa:dyatlov-igor/materia-theme sudo apt update sudo apt install materia-theme |

  1. The AUR package is maintained by @cthbleachbit.

  2. The Copr repository is maintained by @LaurentTreguier.

  3. The Ubuntu PPA is maintained by @igor-dyatlov.

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

Custom Installation

./install.sh allows the following options:

-d, --dest DIR           Specify theme destination directory (Default: /usr/share/themes)
-n, --name NAME          Specify theme name (Default: Materia)
-c, --color VARIANTS...  Specify theme color variant(s) [standard|dark|light] (Default: All variants)
-s, --size VARIANT       Specify theme size variant [standard|compact] (Default: All variants)

For example, to install only Materia-dark into ~/.themes, run:

./install.sh -c dark -s standard -d ~/.themes

For further details, run ./install.sh --help.

To change the color scheme of the theme, see the page.

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 (such as Roboto or M+).

  • Set the font size to 9.75 (= 13px at 96dpi) or 10.5 (= 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 onto 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

Previews

GNOME Shell

GNOME Shell

Budgie Desktop

Budgie Desktop

GDM

GDM

Previews Info: Icon Theme: Paper | Font: M+ 1C 9.75pt | Dock's icon size: 48px + fixed | Wallpapers

Contributing

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

See also (if necessary): TODO.md and HACKING.md

License

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

Credits

  • This theme is based on Adwaita by GNOME.

  • 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.

  • The original concept is Google's Material Design.

  • Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with oomox.

  • @n3oxmind helped improve the installation script.

Also thank you to all contributors and upstream developers.

                
                    
1
# Materia
2
3
Materia (formerly Flat-Plat) is a [Material Design](https://material.io) theme for GNOME/GTK+ based desktop environments.
4
It supports GTK+ 3, GTK+ 2, GNOME Shell, Budgie, MATE, Unity, LightDM, GDM, Chrome theme, etc.
5
6
Also Materia has compatibility with [oomox theme designer](https://github.com/actionless/oomox).
7
8
## Features
9
10
**Ripple effect** animations for GTK+ 3 are supported:
11
12
![Button](../images/Button.gif?raw=true)
13
14
**Three color variants** and **two size variants** are available:
15
16
| **Materia** | **-** | **compact** |
17
|:-:|:-:|:-:|
18
| **-** | ![Materia](../images/Materia.png?raw=true) | ![Materia-compact](../images/Materia-compact.png?raw=true) |
19
| **dark** | ![Materia-dark](../images/Materia-dark.png?raw=true) | ![Materia-dark-compact](../images/Materia-dark-compact.png?raw=true) |
20
| **light** | ![Materia-light](../images/Materia-light.png?raw=true) | ![Materia-light-compact](../images/Materia-light-compact.png?raw=true) |
21
22
Various **desktop environments** are supported:
23
24
- GNOME Shell `>=3.18`
25
- Budgie `>=10.2.5`
26
- MATE `>=1.14`
27
- Unity `>=7.4`
28
- ... and more DEs are [planned](TODO.md#supports).
29
30
## Requirements
31
32
- GTK+ `>=3.18`
33
- `gnome-themes-standard`
34
- Murrine engine - The package name depends on the distro.
35
- `gtk-engine-murrine` on Arch Linux
36
- `gtk-murrine-engine` on Fedora
37
- `gtk2-engine-murrine` on openSUSE
38
- `gtk2-engines-murrine` on Debian, Ubuntu, etc.
39
- `glib-compile-resources` - The package name depends on the distro.
40
- `glib2` on Arch Linux
41
- `glib2-devel` on Fedora, openSUSE, etc.
42
- `libglib2.0-dev` on Debian, Ubuntu, etc.
43
44
For Ubuntu, you'll also need the `libxml2-utils` package.
45
46
## Installation
47
48
#### Packages
49
50
|| **Install command** |
51
|:-|:-|
52
| **Arch Linux** [1] | `yaourt -S materia-theme` |
53
| **Fedora / EPEL** [2] | `sudo dnf copr enable tcg/themes && sudo dnf install materia-theme` |
54
| **Ubuntu** [3] | `sudo add-apt-repository ppa:dyatlov-igor/materia-theme` <br> `sudo apt update` <br> `sudo apt install materia-theme` |
55
56
1. The [AUR package](https://aur.archlinux.org/packages/materia-theme/) is maintained by [@cthbleachbit](https://github.com/cthbleachbit).
57
2. The [Copr repository](https://copr.fedorainfracloud.org/coprs/tcg/themes/) is maintained by [@LaurentTreguier](https://github.com/LaurentTreguier).
58
3. The [Ubuntu PPA](https://launchpad.net/~dyatlov-igor/+archive/ubuntu/materia-theme) is maintained by [@igor-dyatlov](https://github.com/igor-dyatlov).
59
60
#### Manual Installation
61
62
Run the following commands in the terminal:
63
64
```sh
65
cd /tmp && wget -qO - https://github.com/nana-4/materia-theme/archive/master.tar.gz | tar xz
66
cd materia-theme-master
67
sudo ./install.sh
68
```
69
70
#### Custom Installation
71
72
`./install.sh` allows the following options:
73
74
```
75
-d, --dest DIR Specify theme destination directory (Default: /usr/share/themes)
76
-n, --name NAME Specify theme name (Default: Materia)
77
-c, --color VARIANTS... Specify theme color variant(s) [standard|dark|light] (Default: All variants)
78
-s, --size VARIANT Specify theme size variant [standard|compact] (Default: All variants)
79
```
80
81
For example, to install only `Materia-dark` into `~/.themes`, run:
82
83
```sh
84
./install.sh -c dark -s standard -d ~/.themes
85
```
86
87
For further details, run `./install.sh --help`.
88
89
To change the color scheme of the theme, see [the page](HACKING.md#changing-the-color-scheme-with-script).
90
91
#### Manual Uninstallation
92
93
Delete the installed directories:
94
95
```sh
96
sudo rm -rf /usr/share/themes/Materia{,-compact,-dark,-dark-compact,-light,-light-compact}
97
```
98
99
## Recommendations
100
101
#### Font
102
103
- To properly display the theme, use a font family including `Medium` weight (such as [Roboto](https://github.com/google/roboto) or [M+](https://mplus-fonts.osdn.jp)).
104
- Set the font size to `9.75` (= 13px at 96dpi) or `10.5` (= 14px at 96dpi).
105
106
#### Chrome Theme
107
108
To use the Chrome theme;
109
110
1. Open the `chrome` folder on `/usr/share/themes/Materia<-variant>`.
111
2. Drag and drop the `.crx` files onto the Chrome/Chromium Extensions page: `chrome://extensions`
112
113
#### GDM Theme
114
115
You can change the GDM (lock/login screen) theme by replacing the default GNOME Shell theme.
116
See the wiki for details: https://github.com/nana-4/materia-theme/wiki/GDM-Theme
117
118
## Previews
119
120
##### GNOME Shell
121
![GNOME Shell](../images/gnome.png?raw=true)
122
123
##### Budgie Desktop
124
![Budgie Desktop](../images/budgie.png?raw=true)
125
126
##### GDM
127
![GDM](../images/gdm-unlock.png?raw=true)
128
129
<sub>**Previews Info:** Icon Theme: [Paper](https://github.com/snwh/paper-icon-theme) | Font: [M+ 1C](https://mplus-fonts.osdn.jp) 9.75pt | Dock's icon size: 48px + fixed | [Wallpapers](https://imgur.com/a/v2Ovx)</sub>
130
131
## Contributing
132
133
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.
134
135
See also (if necessary): [`TODO.md`](TODO.md) and [`HACKING.md`](HACKING.md)
136
137
## License
138
139
Materia is distributed under the terms of the GNU General Public License, version 2 or later. See the [`COPYING`](COPYING) file for details.
140
141
## Credits
142
143
- This theme is based on [Adwaita](HACKING.md#upstream-theme-sources) by GNOME.
144
- The included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
145
- Chrome/Chromium scrollbars extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.
146
- The original concept is Google's [Material Design](https://material.io).
147
- Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with [oomox](https://github.com/actionless/oomox).
148
- @n3oxmind helped improve the installation script.
149
150
Also thank you to all contributors and upstream developers.
151