Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luisbocanegra/plasma-panel-colorizer
Fully-featured widget to bring Latte-Dock and WM status bar customization features to the default KDE Plasma panel
https://github.com/luisbocanegra/plasma-panel-colorizer
colors customization kde kde-plasma latte-dock linux-desktop panel plasma plasma-applet plasma6 plasmoid theme tray-icons widget
Last synced: 1 day ago
JSON representation
Fully-featured widget to bring Latte-Dock and WM status bar customization features to the default KDE Plasma panel
- Host: GitHub
- URL: https://github.com/luisbocanegra/plasma-panel-colorizer
- Owner: luisbocanegra
- License: gpl-3.0
- Created: 2024-02-19T08:27:10.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-09-18T06:48:12.000Z (8 days ago)
- Last Synced: 2024-09-18T09:04:15.785Z (8 days ago)
- Topics: colors, customization, kde, kde-plasma, latte-dock, linux-desktop, panel, plasma, plasma-applet, plasma6, plasmoid, theme, tray-icons, widget
- Language: QML
- Homepage: https://store.kde.org/p/2130967
- Size: 5.59 MB
- Stars: 159
- Watchers: 2
- Forks: 1
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Panel Colorizer
[](https://aur.archlinux.org/packages/plasma6-applets-panel-colorizer)
[](https://store.kde.org/p/2130967)
[](https://liberapay.com/luisbocanegra/)
Fully-featured widget to bring Latte-Dock and WM status bar customization features to the default Plasma panel.
Inspired by the Latte Dock (now unmaintained) theming and boosted by the laziness to learn editing Plasma themes (which can only change background and other small things) created this project that helps you make the Plasma panels look _almost_ however you want.
## Demo
[](https://www.youtube.com/watch?v=0QLyEexa9Y4)
Settings
## Features
### Presets
* Create your own configuration presets
* Restore defaults
* Preset auto-loading
* Floating panel
* Maximized window shown
### Widget Background
* Color modes
* Static
* Animated
* Interval
* Fading
* Colors
* Custom
* System
* Custom list
* Random
* Contrast correction
* Style
* Spacing
* Margin rules
* Border radius
* Outline
* Opacity
* Shadow
* Line mode
### Icons and text
* Color Modes
* Static
* Interval
* Follow widget background
* Colors
* Custom
* System
* Custom list
* Random
* Contrast correction
* Opacity
* Blacklisted widgets color
* Force icon color to on specific plasmoids that use Kirigami.Icon
* Recolor applications tray icon
* Icons/text shadow
### Panel background
* Opacity
* Color
* Border radius
* Outline
* Constant floating panel side padding
* Shadow
* Remove original panel background
### Other
* Widget Blacklist
## Installing
Install from KDE Store or use `Get new widgets..`
* ~~[Plasma 5](https://store.kde.org/p/2131149) version v0.2.0~~ **[No longer maintained](https://github.com/luisbocanegra/plasma-panel-colorizer/issues/10)**
* [Plasma 6](https://store.kde.org/p/2130967)
### Manually
1. Install these dependencies or their equivalents for your distribution
```txt
cmake extra-cmake-modules libplasma plasma5support
```
2. Run
```sh
git clone https://github.com/luisbocanegra/plasma-panel-colorizer
cd plasma-panel-colorizer
./install.sh
```
### Arch Linux
[aur/plasma6-applets-panel-colorizer](https://aur.archlinux.org/packages/plasma6-applets-panel-colorizer) use your preferred AUR helper e.g:
```sh
yay -S plasma6-applets-panel-colorizer
```
### Nix package
For those using NixOS or the Nix package manager, a Nix package is available in nixpkgs-unstable.
To install the widget use one of these methods:
- NixOS
```nix
environment.systemPackages = with pkgs; [
plasma-panel-colorizer
];
```
- [Home-manager](https://github.com/nix-community/home-manager)
```nix
home.packages = with pkgs; [
plasma-panel-colorizer
];
```
- [Plasma-manager](https://github.com/nix-community/plasma-manager): If the widget gets added to a panel it will automatically be installed
- Other distros using Nix package manager
```
# without flakes:
nix-env -iA nixpkgs.plasma-panel-colorizer
# with flakes:
nix profile install nixpkgs#plasma-panel-colorizer
```
## How to use
1. Put the widget on any of your panels
2. Go to the widget settings to change the current panel appearance (right click > Configure...)
3. Widget can set to only show in panel **Edit Mode** (right click > Hide widget or from the widget settings)
### Restore the original panel appearance
Changes to the panel are not permanent and can be removed by disabling them from **Widget Settings** > **General tab** > **Enabled** checkbox or removing it from the panel and restarting Plasma/logging out.
## Fix Blacklist/Margin/Force recolor not working after updating to version 0.5.0
Since version **0.5.0** partial widget names e.g. _weather_ are no longer allowed. This causes previous rules to stay even after removing the matched widgets.
A button to restore/clear the default rules has been added to the relevant sections.
To fix all saved presets a script is provided:
```sh
git clone https://github.com/luisbocanegra/plasma-panel-colorizer
cd plasma-panel-colorizer
./fix-presets-widget-rules.sh
```
The same script can be used to maintain the same widget rules for all presets
## How it works / hacking
This widget works by inject/managing the background and colors of other widgets and the panel where it is placed, the initial goal was to replicate the famous WM status bar look and some Latte Dock theming options without actually modifying the panel/widgets source code.
### Technical
Background is drawn by creating rectangle areas bellow widgets/panel, text and icons repaint is done by editing some elements color property and overwriting `Kirigami.Theme.Color` colors for others, while this works for most widgets, there are some that won't because they draw text and icons differently to what this project matches, if you find a widget that doesn't get colors let me know [here](https://github.com/luisbocanegra/plasma-panel-colorizer/issues/12) and I will try supporting it.
### Performance
Some widgets really like to create/destroy/recolor their own widget elements (e.g. Global Menu), to account for this, text and icons color are re-applied every 250ms. I tried to optimize it so CPU usage only increases around 1-2% on my computer, but usage could vary depending on your System or how many widgets are in your panels.
## Support the development
If you like the project you can:
[](https://www.buymeacoffee.com/luisbocanegra) [](https://liberapay.com/luisbocanegra/)
Thank you ❤️
## Acknowledgements
* [Search the actual gridLayout of the panel from Plasma panel spacer](https://invent.kde.org/plasma/plasma-workspace/-/blob/Plasma/5.27/applets/panelspacer/package/contents/ui/main.qml?ref_type=heads#L37) code that inspired this project.
* [Google LLC. / Pictogrammers](https://pictogrammers.com/library/mdi/) for the panel icons.
* [sanjay-kr-commit/panelTransparencyToggleForPlasma6](https://github.com/sanjay-kr-commit/panelTransparencyToggleForPlasma6) / [psifidotos/paneltransparencybutton](https://github.com/psifidotos/paneltransparencybutton) for the true panel transparency