https://github.com/luisbocanegra/plasma-wallpaper-effects

KDE Plasma Widget to enable Active Blur and other effects for all Wallpaper Plugins
https://github.com/luisbocanegra/plasma-wallpaper-effects

blur color-effects customization kde kde-plasma linux-desktop plasma plasma6 rounded-corners wallpaper

Last synced: 2 months ago
JSON representation

KDE Plasma Widget to enable Active Blur and other effects for all Wallpaper Plugins

• Host: GitHub
• URL: https://github.com/luisbocanegra/plasma-wallpaper-effects
• Owner: luisbocanegra
• License: gpl-3.0
• Created: 2024-04-09T02:38:44.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-26T08:12:07.000Z (7 months ago)
• Last Synced: 2025-02-08T01:35:47.192Z (3 months ago)
• Topics: blur, color-effects, customization, kde, kde-plasma, linux-desktop, plasma, plasma6, rounded-corners, wallpaper
• Language: Python
• Homepage: https://store.kde.org/p/2145723
• Size: 363 KB
• Stars: 17
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-kde - plasma6-applets-wallpaper-effects
• awesome-kde - plasma6-applets-wallpaper-effects

README

        


# KDE Wallpaper Effects

[![AUR version](https://img.shields.io/aur/version/plasma6-applets-wallpaper-effects?style=for-the-badge&logo=archlinux&labelColor=2d333b&color=1f425f)](https://aur.archlinux.org/packages/plasma6-applets-wallpaper-effects)

[![Dynamic JSON Badge](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fluisbocanegra%2Fplasma-wallpaper-effects%2Fmain%2Fpackage%2Fmetadata.json&query=KPlugin.Version&style=for-the-badge&color=1f425f&labelColor=2d333b&logo=kde&label=KDE%20Store)](https://store.kde.org/p/2145723)

[![Liberapay](https://img.shields.io/liberapay/patrons/luisbocanegra?style=for-the-badge&logo=liberapay&logoColor=%23F6C814&labelColor=%232D333B&label=supporters)](https://liberapay.com/luisbocanegra/)

Plasma Widget to enable Active Blur and other effects for all Wallpaper Plugins

![icon](screenshots/icon.png)



Inspired by the [Zren/inactiveblur](https://github.com/Zren/plasma-wallpapers/tree/master/inactiveblur) ([bouteillerAlan/blurredwallpaper](https://github.com/bouteillerAlan/blurredwallpaper) for plasma 6) but packed into a widget so it can be applied to any Wallpaper Plugin.

## Demo

[![Demo](https://img.shields.io/badge/watch%20on%20youtube-demo?style=for-the-badge&logo=youtube&logoColor=white&labelColor=%23c30000&color=%23222222

)](https://youtu.be/fdTAewwZLVs)

    Screenshots

![tooltip](screenshots/settings.png)

## Features

- **Blur**

  - Conditions

    - Maximized or full-screen window

    - Active window

    - Window is present

    - Always

    - Never

  - Radius

- **Rounded corners**

  - Radius

  - Background color

  - Margins (top, bottom, left, right)

  - Shadow

- **Color effects**

  - Colorization

  - Brightness

  - Contrast

  - Saturation

- **Toggle effects on**

  - Overview

  - Grid

  - Show desktop

- [ ] **Hide desktop widgets/files**

  - [ ] Overview

  - [ ] Grid

  - [ ] Show desktop

- [ ] You tell me

## Installing

### Arch Linux

[aur/plasma6-applets-wallpaper-effects](https://aur.archlinux.org/packages/plasma6-applets-wallpaper-effects) use your preferred AUR helper (e.g `yay -S plasma6-applets-wallpaper-effects`)

### KDE Store

Install the plugin from the KDE Store [Plasma 6 version](https://store.kde.org/p/2145723)

1. **Right click on the Desktop** > **Edit Mode** > **Add Widgets** > **Get New Widgets** > **Download new...**

2. **Search** for "**Wallpaper Effects**", install and add it to your Desktop.

### 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-wallpaper-effects

      cd plasma-wallpaper-effects

      ./install.sh

      ```

## How to use

1. Put the widget on any of your Desktops

2. Go to the widget settings to change the effects and behavior

3. Widget can set to only show in **Desktop Edit Mode** (right click > Hide widget or from the widget settings)

### Restore the original desktop appearance

Changes to the Desktop are not permanent and can be removed by disabling them from **Widget Settings** > **General tab** > **Enabled** checkbox or removing the widget from the Desktop.

## Translations

Instructions to translate the project are available [here](https://github.com/luisbocanegra/plasma-wallpaper-effects/blob/main/package/translate/ReadMe.md)

## How does it work

Similar to [plasma-panel-colorizer](https://github.com/luisbocanegra/plasma-panel-colorizer), this widget works by injecting/managing effects of the existing wallpaper. Replicating the famous Active Blur for all Wallpaper Plugins without having to modify each Plugin source code.

## Support the development

If you like the project you can:

[!["Buy Me A Coffee"](https://img.shields.io/badge/Buy%20me%20a%20coffe-supporter?logo=buymeacoffee&logoColor=%23282828&labelColor=%23FF803F&color=%23FF803F)](https://www.buymeacoffee.com/luisbocanegra) [![Liberapay](https://img.shields.io/badge/Become%20a%20supporter-supporter?logo=liberapay&logoColor=%23282828&labelColor=%23F6C814&color=%23F6C814)](https://liberapay.com/luisbocanegra/)

## Acknowledgements

- [Zren/inactiveblur](https://github.com/Zren/plasma-wallpapers/tree/master/inactiveblur) [bouteillerAlan/blurredwallpaper](https://github.com/bouteillerAlan/blurredwallpaper)

- [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 icons.