https://github.com/deter0/xborder

Active window border replacement for window managers.
https://github.com/deter0/xborder

Last synced: 2 months ago
JSON representation

Active window border replacement for window managers.

• Host: GitHub
• URL: https://github.com/deter0/xborder
• Owner: deter0
• License: unlicense
• Created: 2022-03-27T11:54:41.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-05-22T19:42:17.000Z (8 months ago)
• Last Synced: 2024-08-01T19:53:58.395Z (5 months ago)
• Language: Python
• Size: 82 KB
• Stars: 370
• Watchers: 4
• Forks: 21
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - deter0/xborder - Active window border replacement for window managers. (Python)
• awesome-github-repos - deter0/xborder - Active window border replacement for window managers. (Python)
• awesome-rainmana - deter0/xborder - Active window border replacement for window managers. (Python)

README

        
# xborders

Active window border replacement for window managers.

## Usage

```sh

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](https://github.com/yshui/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:

![image](https://user-images.githubusercontent.com/82973108/160370439-8b7a5feb-c186-4954-a029-b718b59fd957.png)

## i3 default:

![image](https://user-images.githubusercontent.com/82973108/160370578-3ea7e3e9-723a-4054-b7b0-2b0110d809c0.png)

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