Active window border replacement for window managers.

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

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.

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

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'",
  ...
];

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).

Now you can specify only the apps to which you want to add a border, instead of all apps:

{
    "border-rgba": "#FFFFFFFF",
    "border-radius": 14,
    "border-width": 4,
    "border-mode": "outside",
    "apply-only": false,
    "apply-only-list": ["Xfce4-terminal", "Alacritty", "kitty", "URxvt", "XTerm"],
    "disable-version-warning": false,

    "positive-x-offset": 0,
    "positive-y-offset": 0,
    "negative-x-offset": 0,
    "negative-y-offset": 0
}

The option apply-only is a flag which you can enable (by default is disabled), and apply-only-list is the list of CLASSNAME of your X apps.

How to discover my terminal CLASSNAME:

xdotool getwindowclassname $WINDOWID

To discover other CLASSNAME of your apps, just search for them on the internet.

cd into the xborders directory and run git pull origin main