swayblur

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

Installation

Stable Release

Swayblur is available in the AUR, NUR or from pypi:

pip install --user swayblur

Building from Source

git clone https://github.com/willpower3309/swayblur
cd swayblur
pip install --user .

Dependencies

• python-i3ipc: build dependency for communicating with Sway
• ImageMagick: used to generate the blurred wallpaper
• oguri: used to set the wallpaper without displaying a gray screen for a split second

Usage

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

Configuration

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 *]
image=PATH_TO_YOUR_WALLPAPER
filter=nearest
scaling-mode=fill
anchor=center