swayblur

Basic sway wallpaper auto-blurring script


Keywords
sway, blur, wallpaper, desktop, ricing, python, swaywm
License
MIT
Install
pip install swayblur==1.1.0

Documentation

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

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