by roundabout, Wednesday, 4 October 2017, 16:07:32 (1507133252), pushed by roundabout, Sunday, 11 May 2025, 13:22:15 (1746969735)
Author identity: nana-4 <hnmaigo@gmail.com>
e8119edde0dbf9508b89a5bd0dd87622ac5bec15
README.md
@@ -1,53 +1,61 @@
Materia
=========
=======
Materia (formerly named Flat-Plat) is a [Material Design](https://material.io)-like 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](https://github.com/actionless/oomox).
Also Materia has compatibility with [oomox theme designer](https://github.com/actionless/oomox).
Features
--------
<img src="../images/Button.gif" alt="Button" align="right"/>
**Ripple effect** animations for GTK+ 3 are supported.
- Supports ripple effect animations for GTK+ 3.
- Supports both light and dark variants.
- Supports dark and light titlebar variants.
- Supports compact variant for low resolution.
Requirements
------------
- GTK+ `>=3.18`
- `gnome-themes-standard`
- murrine engine
**Three color variants** and **two size variants** are available.
| **Materia** | **-** | **compact** |
|:-:|:-:|:-:|
| **-** |  |  |
| **dark** |  |  |
| **light** |  |  |
Various **desktop environments** are supported.
#### Supported desktop environments
- GNOME Shell `>=3.18`
- Budgie `>=10.2.5`
- MATE `>=1.14`
- Unity `>=7.4`
#### Build dependency
- `glib2` on Arch Linux
- `glib2-devel` on Fedora, openSUSE, etc
- `libglib2.0-dev` on Debian, Ubuntu, etc
- ... and more DEs are [planned](TODO.md#supports).
Installation
------------
For **Arch Linux**, the [AUR package](https://aur.archlinux.org/packages/flatplat-theme) maintained by @cthbleachbit is available.
```sh
sudo yaourt -S flatplat-theme
```
#### Packages
For **Fedora** or **EPEL**, the [Copr repository](https://copr.fedorainfracloud.org/coprs/tcg/themes/) maintained by @LaurentTreguier is available.
|| **Install command** |
|:-|:-|
| **Arch Linux** [1] | `sudo yaourt -S flatplat-theme` |
| **Fedora / EPEL** [2] | `sudo dnf copr enable tcg/themes && sudo dnf install Flat-Plat-theme` |
```sh
sudo dnf copr enable tcg/themes
sudo dnf install Flat-Plat-theme
```
1. The [AUR package](https://aur.archlinux.org/packages/flatplat-theme/) is maintained by [@cthbleachbit](https://github.com/cthbleachbit).
2. The [Copr repository](https://copr.fedorainfracloud.org/coprs/tcg/themes/) is maintained by [@LaurentTreguier](https://github.com/LaurentTreguier).
#### Manual Installation
Run the following commands in the terminal.
Check the dependencies first.
- 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.
Install the theme with the following commands.
```sh
cd /tmp && curl -sL https://github.com/nana-4/materia-theme/archive/v20170917.tar.gz | tar xz
@@ -56,6 +64,7 @@ sudo ./install.sh
```
#### Manual Uninstallation
Delete the installed directories.
```sh
@@ -65,11 +74,13 @@ sudo rm -rf /usr/share/themes/Flat-Plat{,-compact,-dark,-dark-compact,-light,-li
Recommendations
---------------
#### Font
- To properly display the theme, use a font family including `Medium` weight (like [Roboto](https://github.com/google/roboto) or [M+](https://mplus-fonts.osdn.jp)).
- 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)).
- Set the font size to `9.75` (= 13px at 96dpi) or `10.5` (= 14px at 96dpi).
#### Chrome Theme
To use the Chrome theme, open the `chrome` folder on `/usr/share/themes/Flat-Plat<-variant>` and drag and drop the `.crx` files onto the Chrome/Chromium _Extensions_ page.
To use the Chrome theme,
1. Open the `chrome` folder on `/usr/share/themes/Flat-Plat<-variant>`.
2. Drag and drop the `.crx` files onto the Chrome/Chromium _Extensions_ page: `chrome://extensions`
GDM Theme
---------
@@ -102,8 +113,8 @@ However, if it fails, the desktop environment may not operate correctly. So plea
2. Restart GNOME Shell. (If you are running _GNOME on Xorg_, press <kbd>Alt</kbd> + <kbd>F2</kbd> then type `r`.)
Preview
-------
Previews
--------
##### GNOME Shell
##### Budgie Desktop
@@ -114,8 +125,7 @@ Preview
Contributing
------------
If you find bugs or have suggestions, please report it to the [issue tracker](https://github.com/nana-4/materia-theme/issues).
Any contribution will be much appreciated.
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.
See also (if necessary): [`TODO.md`](TODO.md) and [`HACKING.md`](HACKING.md)
@@ -125,10 +135,10 @@ Materia is distributed under the terms of the GNU General Public License, versio
Credits
-------
- This theme is based on [Adwaita](HACKING.md#useful-links) by GNOME.
- This theme is based on [Adwaita](HACKING.md#upstream-theme-sources) by GNOME.
- The included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
- Chrome/Chromium scrollbars extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.
- The original concept is Google's [Material Design](https://material.io).
- Yauhen Kirylau (@actionless) who is oomox author polished scripts and supported Materia with [oomox](https://github.com/actionless/oomox).
Also thank you for all contributors and upstream developers.
Also thank you to all contributors and upstream developers.