README.md
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.
Three color variants and two size variants are available.
| Materia | - | compact |
|:-:|:-:|:-:|
| - |
|
|
| dark |
|
|
| light |
|
|
Various desktop environments are supported.
GNOME Shell
>=3.18Budgie
>=10.2.5MATE
>=1.14Unity
>=7.4... and more DEs are planned.
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 |
The AUR package is maintained by @cthbleachbit.
The Copr repository is maintained by @LaurentTreguier.
Manual Installation
Check the dependencies first:
GTK+
>=3.18gnome-themes-standardMurrine engine - The package name depends on the distro.
gtk-engine-murrineon Arch Linuxgtk-murrine-engineon Fedoragtk2-engine-murrineon openSUSEgtk2-engines-murrineon Debian, Ubuntu, etc.
glib-compile-resources- The package name depends on the distro.glib2on Arch Linuxglib2-develon Fedora, openSUSE, etc.libglib2.0-devon Debian, Ubuntu, etc.
Did you get the error: XMLLINT not set and xmllint not found in path? Then you'll also need to install libxml2-utils.
Install the theme with the following commands:
cd /tmp && curl -sL https://github.com/nana-4/materia-theme/archive/v20171005.tar.gz | tar xz cd materia-theme-20171005 sudo ./install.sh
Manual Uninstallation
Delete the installed directories:
sudo rm -rf /usr/share/themes/{Materia,Flat-Plat}{,-compact,-dark,-dark-compact,-light,-light-compact}
Recommendations
Font
To properly display the theme, use a font family including
Mediumweight (such as Roboto or M+).Set the font size to
9.75(= 13px at 96dpi) or10.5(= 14px at 96dpi).
Chrome Theme
To use the Chrome theme;
Open the
chromefolder on/usr/share/themes/Materia<-variant>.Drag and drop the
.crxfiles 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
Budgie Desktop
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.
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

13
14
**Three color variants** and **two size variants** are available.
15
16
| **Materia** | **-** | **compact** |
17
|:-:|:-:|:-:|
18
| **-** |  |  |
19
| **dark** |  |  |
20
| **light** |  |  |
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
## Installation
31
32
#### Packages
33
34
|| **Install command** |
35
|:-|:-|
36
| **Arch Linux** [1] | `yaourt -S materia-theme` |
37
| **Fedora / EPEL** [2] | `sudo dnf copr enable tcg/themes && sudo dnf install materia-theme` |
38
39
1. The [AUR package](https://aur.archlinux.org/packages/materia-theme/) is maintained by [@cthbleachbit](https://github.com/cthbleachbit).
40
2. The [Copr repository](https://copr.fedorainfracloud.org/coprs/tcg/themes/) is maintained by [@LaurentTreguier](https://github.com/LaurentTreguier).
41
42
#### Manual Installation
43
44
Check the dependencies first:
45
46
- GTK+ `>=3.18`
47
- `gnome-themes-standard`
48
- Murrine engine - The package name depends on the distro.
49
- `gtk-engine-murrine` on Arch Linux
50
- `gtk-murrine-engine` on Fedora
51
- `gtk2-engine-murrine` on openSUSE
52
- `gtk2-engines-murrine` on Debian, Ubuntu, etc.
53
- `glib-compile-resources` - The package name depends on the distro.
54
- `glib2` on Arch Linux
55
- `glib2-devel` on Fedora, openSUSE, etc.
56
- `libglib2.0-dev` on Debian, Ubuntu, etc.
57
58
Did you get the error: `XMLLINT not set and xmllint not found in path`? Then you'll also need to install `libxml2-utils`.
59
60
Install the theme with the following commands:
61
62
```sh
63
cd /tmp && curl -sL https://github.com/nana-4/materia-theme/archive/v20171005.tar.gz | tar xz
64
cd materia-theme-20171005
65
sudo ./install.sh
66
```
67
68
#### Manual Uninstallation
69
70
Delete the installed directories:
71
72
```sh
73
sudo rm -rf /usr/share/themes/{Materia,Flat-Plat}{,-compact,-dark,-dark-compact,-light,-light-compact}
74
```
75
76
## Recommendations
77
78
#### Font
79
80
- 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)).
81
- Set the font size to `9.75` (= 13px at 96dpi) or `10.5` (= 14px at 96dpi).
82
83
#### Chrome Theme
84
85
To use the Chrome theme;
86
87
1. Open the `chrome` folder on `/usr/share/themes/Materia<-variant>`.
88
2. Drag and drop the `.crx` files onto the Chrome/Chromium Extensions page: `chrome://extensions`
89
90
#### GDM Theme
91
92
You can change the GDM (lock/login screen) theme by replacing the default GNOME Shell theme.
93
See the wiki for details: https://github.com/nana-4/materia-theme/wiki/GDM-Theme
94
95
## Previews
96
97
##### GNOME Shell
98

99
100
##### Budgie Desktop
101

102
103
##### GDM
104

105
106
<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>
107
108
## Contributing
109
110
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.
111
112
See also (if necessary): [`TODO.md`](TODO.md) and [`HACKING.md`](HACKING.md)
113
114
## License
115
116
Materia is distributed under the terms of the GNU General Public License, version 2 or later. See the [`COPYING`](COPYING) file for details.
117
118
## Credits
119
120
- This theme is based on [Adwaita](HACKING.md#upstream-theme-sources) by GNOME.
121
- The included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
122
- Chrome/Chromium scrollbars extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.
123
- The original concept is Google's [Material Design](https://material.io).
124
- Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with [oomox](https://github.com/actionless/oomox).
125
126
Also thank you to all contributors and upstream developers.
127