Skip to main content

Smoothly blurs the wallpaper when windows are opened.

Project description

BlurWal Logo

Smoothly blurs the wallpaper when windows are opened.


BlurWal smoothly blurs the wallpaper when a given number of windows is opened on the focused workspace. This is done by first generating transition frames from the current wallpaper, with each of them being blurred with an increasing level. Upon opening enough windows, each frame will be set as the wallpaper in quick succession, resulting in a transition. When the number of open windows goes below the threshold again, the transition will run in reverse and consequently unblur the wallpaper.

Table of Contents



  • Python 3.6+
  • ImageMagick (for generating transition frames)
  • A compatible backend, depending on your environment

Supported Backends

Name in CLI Command used Environment Availability
feh feh Most WMs (i3, awesome, bspwm, Openbox, etc.) Separate package
xfce xfconf-query Xfce (uses xfconf to store wallpaper configuration) Part of Xfce

Stable Release

pip install --user blurwal

Also available in the Arch User Repository as blurwal

Installing from the AUR is preferred, as BlurWal will be updated together with the rest of your system.

Development Version

git clone
cd blurwal
pip install --user .

The latest changes on master, which may not be as stable.


Simply run blurwal and it will regenerate its transition frames and blur on the appropriate window events.


This list includes only the interesting options – run blurwal -h for a complete list and further information.

Option Description
-m, --min The minimum number of windows to blur the wallpaper (default: 2)
-s, --steps The number of steps in a blur transition (default: 10, minimum: 2)
-b, --blur The blur strength (sigma) to use when fully blurred (default: 10)
-i, --ignore A space-separated list of window classes to exclude
--backend The backend to use (one of the compatible backends)

Multi-monitor Setups

Multi-monitor configurations are only partially supported. Depending on the backend, BlurWal will use the wallpaper of your primary monitor (and first workspace) and apply it to all monitors, only taking the focused workspace and the number of windows on it into account. This also means that using different wallpapers per individual monitor is not possible, as all will be overwritten with the primary one.

Changing this behavior is planned but will require some major changes.





BlurWal is licensed under the MIT license. See LICENSE for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for BlurWal, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size BlurWal-1.1.1-py3-none-any.whl (18.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size BlurWal-1.1.1.tar.gz (12.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page