Skip to main content

Basic sway wallpaper auto-blurring script

Project description


Basic i3ipc based script to blur an output's wallpaper when a client is present in it. Available via pypi or the NUR.


Stable Release

Swayblur is available in the NUR or from pypi:

pip install --user swayblur

Building from Source

git clone
cd swayblur
pip install --user .



In order for the script to run as expected, your sway config should not set any wallpaper. Remove the output * bg PATH line.

swayblur does not spawn oguri at launch. If spawning swayblur with a sway config via exec, ensure that exec oguri occurs before swayblur is executed!

swayblur [-h] [-b BLUR] [-a ANIMATE] [-c CONFIG-PATH] [-v] [--verbose]

Option Description
-b, --blur blur strength (default: 20, min: 5, max: 100)
-a, --animate animation duration (default: 1, min: 1, max: 20)
-c, --config-path oguri config path (default: $XDG_CONFIG_HOME/oguri/config)
--verbose prints additional information
-v, --version show program's version number and exit
-h, --help show the help message and exit


Since swayblur requires oguri, it reads its config file: ~/.config/oguri/config. I personally use the below config, it's about as minimal as you can get:

[output *]

Project details

Download files

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

Source Distribution

swayblur-1.1.1.tar.gz (8.2 kB view hashes)

Uploaded source

Built Distribution

swayblur-1.1.1-py3-none-any.whl (8.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page