• Stars
    star
    217
  • Rank 182,446 (Top 4 %)
  • Language
    Python
  • License
    GNU General Publi...
  • Created over 2 years ago
  • Updated 11 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Automatic Material You Colors Generator from your wallpaper for the Plasma Desktop

🎨 KDE Material You Colors

Automatic Material You Colors Generator from your wallpaper for the Plasma Desktop

This is a Python program that uses the Python implementation of Google's Material Color Utilities to generate a Material Design 3 color scheme. Which is used to generate Light and Dark Color Themes for KDE (and pywal if installed) from your current wallpaper, automatically.

Screenshot

Features

Plasma specific

  • Update automatically on wallpaper change
  • Multiple wallpaper plugins supported
  • Support for selecting Wallpaper plugin from secondary monitors
  • Dark and Light Icon theme
  • Support Plasma 5.26+ dark wallpaper variants
  • Start automatically on login
  • Make titlebar darker to match specified applications like terminals, code editors and other programs themed by pywal
  • Follow Plasma Material You Dark/Light change to work with theme schedulers like Koi
  • Plasma addons

Themeable programs

  • Konsole color scheme
    • opacity control
  • Pywal support to theme other programs using Material You Colors
  • Basic KSyntaxHighlighting support (Kate, KWrite, KDevelop...)

Theming options

  • Alternative Material You color selection if the wallpaper provides more than one
  • Use your favorite color to generate Material You color schemes
  • Custom colors list used for konsole/pywal
  • Custom amount for background color tint
  • Dark/light Color schemes (Plasma and pywal/konsole independently)
  • Set a script/command that will be executed on start or wallpaper/dark/light/settings change
  • Configuration file

Installing

Arch Linux

  • AUR use your preferred AUR helper

openSUSE Build Service packages by @markusgod

Fedora

Add repository and install as root:

dnf config-manager --add-repo https://download.opensuse.org/repositories/home:MarkNefedov/Fedora_37/home:MarkNefedov.repo
dnf install kde-material-you-colors

openSUSE

For openSUSE Tumbleweed add repository and install as root:

zypper addrepo https://download.opensuse.org/repositories/home:MarkNefedov/openSUSE_Tumbleweed/home:MarkNefedov.repo
zypper refresh
zypper install kde-material-you-colors

For openSUSE 15.4 add repository and install as root:

zypper addrepo https://download.opensuse.org/repositories/home:MarkNefedov/15.4/home:MarkNefedov.repo
zypper refresh
zypper install kde-material-you-colors

Other distributions/manual install

Expand
  1. Clone/download this repository and cd to it
git clone https://github.com/luisbocanegra/kde-material-you-colors --branch main
cd kde-material-you-colors
  1. Make the installer executable and run it as root

For Ubuntu based distros:

chmod +x install-ubuntu-based.sh
sudo ./install-ubuntu-based.sh

For Fedora based distros:

chmod +x install-fedora-based.sh
sudo ./install-fedora-based.sh

Updating

Fetch latest changes:

cd kde-material-you-colors
git pull

Repeat step 2

Optional features

  • Install the Colr python module to display colored palette and seed colors from terminal
  • Install the pywal python module to theme other programs using Material You Colors

Running

From terminal to debug your configuration

  • Run kde-material-you-colors from terminal, this should change your Desktop colors right after.

NOTE: Without any configuration/arguments your wallpaper will be reset to Image Wallpaper Plugin

Options

  • Run kde-material-you-colors -h to see the list of available options

Desktop entries

  • To start/restart the program launch KDE Material You Colors from your applications list
  • To stop it launch Stop KDE Material You Colors from your applications list

Startup script

After finishing the setup, you can make it run automatically on boot

  1. Copy the default configuration to ~/.config/kde-material-you-colors/config.conf:

kde-material-you-colors -c

  1. Set the program to automatically start with Plasma:

kde-material-you-colors -a

  1. Reboot or logout/login and test the changes,

NOTE: your wallpaper will be reset to Image Wallpaper Plugin

Removing the autostart script

  1. Open System Settings > Startup and Shutdown
  2. Remove kde-material-you-colors by clicking on the - button.

Changing Current Wallpaper plugin

Use the configuration file !!

Using Plasma Wallpaper Settings may Crash Plasmashell and will set again the plugin from Configuration file

Working Wallpaper plugins

This is a list of compatible Plasma Wallpaper Plugins

Name ID
Image (default) org.kde.image
Picture of the day org.kde.potd
Slideshow org.kde.slideshow
Plain color org.kde.color

Configuration file

  • Copy default configuration: run kde-material-you-colors -c
  • Edit ~/.config/kde-material-you-colors/config.conf
  • Run kde-material-you-colors with no arguments from terminal to test it.
  • You can view the sample configuration file here

Notes

  • To update color with plasma-apply-colorscheme (utility provided by plasma developers), the file containing the new color scheme must have a different name than the current one, to workaround this the program creates two scheme files with different names, then applies one after the other. As a result you end up with duplicated color schemes and maybe some lag while updating schemes.

Bug reporting / Feature requests / Contributing

Please read the Contributing guidelines in this repository

Thanks & Credits

More Repositories

1

substratum-tweaks

A substratum "theme" to tweak Android's resource values on recent android versions.
Kotlin
27
star
2

linux-pause-auto-sleep-and-lock

Manually block auto suspend and screen locking from commandline or a keyboard shortcut
Python
11
star
3

plasma-panel-spacer-extended

Plasma panel spacer with mouse actions. An attempt to bring Latte Dock's window actions (like Drag Window and more!) to the default Plasma panel
QML
9
star
4

linux-guide-split-audio-ports

Split jack(headphones)/speakers outputs into individual sinks on Linux to allow simultaneous playback (listen to different audio streams on each port)
9
star
5

ASUSLongScreenshot

ASUSLongScreenshot
Shell
8
star
6

kwin-panel-auto-hide

A KWin script that hides Plasma panels when there are maximized windows
JavaScript
7
star
7

plasma-simple-window-buttons

Simple QML only alternative to psifidotos Window buttons for Plasma 6
QML
6
star
8

plasma-intel-gpu-monitor

KDE Plasma Widget that displays Intel GPU usage including wether or not video acceleration is being used.
QML
3
star
9

breeze-folder-icons-patcher

Patch breeze folder icons to support darker accent colors
Shell
2
star
10

plasma-do-not-unplug-yet

Simple Plasma Widget that shows/hides an icon when files are being transferred in the background to removable drives
QML
2
star
11

latte-dock-colored-indicators

Latte Dock indicators that follow icon colors
QML
2
star
12

plasma-cursor-eyes

Follow mouse widget for the KDE Plasma Desktop. A small demo of getting KWin Script output from a Plasma Widget using D-Bus and Python
QML
2
star
13

Konsole-TabBar-themes

User-defined Konsole Tab Bar Themes
CSS
1
star