swayblur
Basic i3ipc based script to blur an output's wallpaper when a client is present in it. Available via pypi or the NUR.
Installation
Stable Release
Swayblur is available in the 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