xborders

Active window border replacement for window managers.

Usage

git clone https://github.com/deter0/xborder
cd xborder
chmod +x xborders
pip install -r requirements.txt
./xborders --help

Dependencies

Make sure to install dependencies first! pip install -r requirements.txt

pycairo (Tested with version 1.21.0)
requests (Tested with version 2.28.1)
libwnck (Tested with version 40.1-1, Arch: sudo pacman -S libwnck3 Debian: sudo apt install libwnck-3-0 NOTE: may need 'libwnck-3-0-dev' for Debian)
gtk
a compositor (picom is what I am using or you can use another compositor) although even compton with work, just something that supports transparent windows.

Recommended Dependencies

libnotify (Debian: sudo apt install libnotify-bin Arch: sudo pacman -S libnotify)

Note for compositor

If you don't want your entire screen blurred please add role = 'xborder' to your blur-exclude!

blur-background-exclude = [
  # prevents picom from blurring the background
  "role   = 'xborder'",
  ...
];

xborders ontop of i3:

i3 default:

Config

Configuration options can be found by passing in the argument --help on the command line, or by specifying a config file with the argument -c. The config file is just a simple json file with the keys being the same as the command-line arguments (except without the "--" at the beginning).

Updating

cd into the xborders directory and run git pull origin main

deter0 / xborder