Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/PapirusDevelopmentTeam/materia-kde

Materia KDE customization
https://github.com/PapirusDevelopmentTeam/materia-kde

desktop-environment kde-desktop linux materia papirus papirus-icons plasma-theme theme

Last synced: 13 days ago
JSON representation

Materia KDE customization

Host: GitHub
URL: https://github.com/PapirusDevelopmentTeam/materia-kde
Owner: PapirusDevelopmentTeam
License: gpl-3.0
Created: 2018-04-13T11:30:03.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-03-19T07:19:56.000Z (8 months ago)
Last Synced: 2024-08-02T01:21:49.773Z (3 months ago)
Topics: desktop-environment, kde-desktop, linux, materia, papirus, papirus-icons, plasma-theme, theme
Language: QML
Homepage: https://git.io/materia-kde
Size: 24.7 MB
Stars: 616
Watchers: 14
Forks: 40
Open Issues: 13
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        

# Materia KDE

This is a port of the popular [GTK theme Materia](https://github.com/nana-4/materia-theme) for the Plasma 5 desktop with a few additions and extras.

In this repository you'll find:

- Aurorae window decoration themes

- Konsole color schemes

- Kvantum themes

- Plasma color schemes

- Plasma Desktop themes

- Plasma Look-and-Feel settings

- Yakuake skins

- SDDM themes

- Wallpapers

## Installation

### Ubuntu and derivatives

You can install materia-kde from our official [PPA](https://launchpad.net/~papirus/+archive/ubuntu/papirus):

```

sudo add-apt-repository ppa:papirus/papirus

sudo apt-get update

sudo apt-get install --install-recommends materia-kde

```

or download .deb packages from [here](https://launchpad.net/~papirus/+archive/ubuntu/papirus/+packages?field.name_filter=materia-kde).

### Materia KDE installer

#### Install

Use this command to install the latest version directly from this repo (independently of your distro):

```

wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/materia-kde/master/install.sh | sh

```

#### Uninstall

```

wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/materia-kde/master/install.sh | uninstall=true sh

```

### Third-party packages

Packages in this section are not part of the official repositories. If you have any questions or concerns about any of these packages, please contact the package maintainer.

| **Distro** | **Maintainer** | **Package** |

|:-----------|:---------------|:------------|

| Arch Linux | Bruno Pagani | `sudo pacman -S materia-kde kvantum-theme-materia` ^{[[link](https://www.archlinux.org/packages/community/any/materia-kde/)]} |

| Arch Linux | Josip Ponjavic | [materia-kde-git](https://aur.archlinux.org/packages/materia-kde-git) ^AUR |

| openSUSE   | Konstantin Voinov | [materia-kde](https://software.opensuse.org/download.html?project=home:kill_it&package=materia-kde) ^{OBS [[link](https://build.opensuse.org/package/show/home:kill_it/materia-kde)] |

| Fedora     | Robert-André Mauchin | `sudo dnf install materia-kde` ^{[[src](https://src.fedoraproject.org/rpms/materia-kde)]} |

| Debian 10+ | Debian Desktop Themes Team | [materia-kde](https://tracker.debian.org/pkg/materia-kde) |}

**NOTE:** If you are a maintainer and want your package to be in this list, please feel free to create an issue or pull request.

## Recommendations

- For a more consistent look on Qt and KDE apps, please use this theme with the [Kvantum engine](https://github.com/tsujan/Kvantum). \

  Run `kvantummanager`, then choose and apply the **Materia** theme.

- Install [Papirus icon theme](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) for a more consistent and beautiful experience.

- Install and use these widgets: [Minimal Menu](https://www.opendesktop.org/p/1275285/) and [Digital Clock WL](https://www.opendesktop.org/p/1311422/)

- Change the System Settings view to **Icons View**

- Set the icon size for Toolbar and Main Toolbar to **16px**

- Set the border size to **No Borders** in Window Decoration settings

### Hacks for smaller screen resolutions

- Install the [Active Window Control](https://www.opendesktop.org/p/998910/) and [Application Menu](https://cgit.kde.org/plasma-workspace.git/tree/applets/appmenu) widgets, and move them to a panel. \

  (**NOTE:** Application Menu is already included with recent versions of KDE Plasma, so there is no need to install it manually.)

- Disable window buttons and titlebar on window decorations:

  - Open the theme's rc file (**Materiarc**, **Materia-Darkrc**, or **Materia-Lightrc**) on the Aurorae themes folder (this is usually located in **~/.local/share/aurorae/themes** or **/usr/share/aurorae/themes**) and change the following lines:

    ```

    ButtonHeight=0

    ButtonWidth=0

    TitleHeight=0

    TitleEdgeTop=0

    ```

  - To hide window buttons on GTK 3 apps, use the [GTK3-noCSD](https://github.com/PCMan/gtk3-nocsd) script

## Known issues

### Aurorae rendering bugs with NVIDIA graphics

On systems using the proprietary NVIDIA video driver, Aurorae window decorations [do not render properly](https://bugs.kde.org/show_bug.cgi?id=384457) by default with all themes.

| **Wrong rendering** | **Correct rendering** |

|:--------------------|:----------------------|

| ![wrong-rendering](https://i.imgur.com/rS5OgPf.png) | ![right-rendering](https://i.imgur.com/5OKjULE.png) |

To fix that, use this config on **~/.Xresources**:

```

Xft.dpi:       96

Xft.antialias: true

Xft.hinting:   true

Xft.autohint:  false

Xft.hintstyle: hintslight

Xft.lcdfilter: lcddefault

Xft.rgba:      rgb

```

Restart your PC to apply these changes.

### Inconsistent styles in QML/Kirigami apps

Recent Qt and KDE apps now use QML or Kirigami — these do *NOT* fully support theming on *any* engine because more elements are *hardcoded*. Please do not submit new issues regarding such apps; we can't do anything to fix them.

Affects apps include, but are not limited to:

- Muon Discover

- Kirigami Gallery

- Ikona

- Alligator

- Kaidan

- Elisa

- KDE Itinerary

- KTrip

- Kirogi

- VVave (ex Babe)

- Keysmith

- Calindori

- KDE Connect SMS Module

- Some `systemsettings5` and `kcm` modules

- and more...

## More Materia themes

- [Materia skin for VLC](https://github.com/PapirusDevelopmentTeam/materia-vlc)

- [Telegram theme](https://t.me/addtheme/MateriaDarkUpdated)

- [Pegasus Frontend theme](https://github.com/varlesh/pegasus-materia-dark)

## Donate

## License

Copyright © 2018–2021 [Alexey Varfolomeev](https://github.com/varlesh) and contributors.

This program is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.

This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.

You should have received a copy of the GNU General Public License

along with this program.  If not, see .