Skip to main content
BlurWal Logo

Smoothly blurs the wallpaper when windows are opened.

BlurWal

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

Installation

Dependencies

  • 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 https://gitlab.com/BVollmerhaus/blurwal
cd blurwal
pip install --user .

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

Usage

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

CLI

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.

Contributors

Maintainer

Others

License

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

Metadata

Release files for BlurWal 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for BlurWal 1.1.1
File Size Uploaded
BlurWal-1.1.1.tar.gz 12.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for BlurWal 1.1.1
File Interpreter ABI Platform
BlurWal-1.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 31.8 kB

Release files / BlurWal-1.1.1.tar.gz

Download URL BlurWal-1.1.1.tar.gz
Size 12.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7a01e474ed37d436ac68ea06a250958ca9436a22cdf5801f4cdc861b7b64daa6
BLAKE2b-256 checksum
How to use checksums
90ace2fa1183438e218c22ffbbe1d8a4140b124d63a4d11c972baa1afb7a3b2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

Release files / BlurWal-1.1.1-py3-none-any.whl

Download URL BlurWal-1.1.1-py3-none-any.whl
Size 18.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
18a4666fc9a5a3e0b28dbe586a5007a2e38eff32dda2037c4d289fdcd913c081
BLAKE2b-256 checksum
How to use checksums
4fd5b600fd3409cd45412ec1e49b1ac176db1979ccf89c982dc7c3c0e1a69cfb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

Release history Release notifications | RSS feed

This release

1.1.1 This release

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page