Metadata-Version: 2.1
Name: swayblur
Version: 1.0.0
Summary: Basic sway wallpaper auto-blurring script
Home-page: https://github.com/willpower3309/swayblur
Author: William McKinnon
Author-email: contact@willmckinnon.com
License: MIT
Project-URL: Code, https://github.com/willpower3309/swayblur
Project-URL: Issues, https://github.com/willpower3309/swayblur/issues
Keywords: sway,blur,wallpaper,desktop,ricing
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# swayblur
Basic i3ipc based script to blur an output's wallpaper when a client is present in it.

<div align="center">
  <img src="https://github.com/WillPower3309/swayblur/blob/main/image.jpg?raw=true" />
</div>

## Installation

### Dependencies
+ `python-i3ipc`
+ `ImageMagick`: Used to generate the blurred wallpaper
+ `oguri`: used to set the wallpaper [without displaying a gray screen for a split second](https://github.com/swaywm/sway/issues/3693)

### Stable Release

```sh
pip install --user swayblur
```

### Development Release

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

## Usage
`swayblur [-h] [-b BLUR] [-a ANIMATE] [-c CONFIG-PATH]`

| 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) |
| `-v`, `--verbose`     | prints additional information                                |
| `-h`, `--help`        | show the help message and exit                               |

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

## 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
```


