Skip to main content

Simple focus animations for tiling window managers

Project description

# flashfocus

Simple focus animations for tiling window managers.

![Demo gif](demo/demo.gif)

<br>

When the focused window changes, flashfocus briefly decreases the window
opacity then slowly fades the window back to full opacity to create a flash
effect.

Compatible with all X based window managers (i3, bspwm, awesome-wm, xmonad...).

## Installation

An active window compositor is required for the effects of flashfocus to be
noticeable. If you don't have one setup already, I recommend
[compton](https://github.com/chjj/compton).

### Arch

Install from the Arch User Repository: `flashfocus-git`

### Ubuntu/Debian

```
sudo apt-get install libxcb-render0-dev;
pip install flashfocus
```

## Configuration

Flashfocus should be added to your startup programs. E.g for i3 put the
following in your config:

```
exec_always --no-startup-id flashfocus
```

Flashfocus also includes the `flash_window` script for flashing the current window in response to a keybinding. E.g if you'd like to bind to mod+n in i3:

```
bindsym $mod+n exec --no-startup-id flash_window
```

See `flashfocus --help` for extra configuration options.

### Tabbed containers in i3

The animations don't work well out of the box for i3 tabs. You'll need to add
the following to your compton config:

```
opacity-rule = [
"0:_NET_WM_STATE@:32a *= '_NET_WM_STATE_HIDDEN'"
];
```



Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flashfocus-0.2.0.tar.gz (9.0 MB view hashes)

Uploaded Source

Built Distribution

flashfocus-0.2.0-py2.py3-none-any.whl (11.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page