Need help with flashfocus?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

fennerm
644 Stars 10 Forks MIT License 312 Commits 6 Opened issues

Description

Simple focus animations for tiling window managers.

Services available

!
?

Need anything else?

Contributors list

# 146,869
Kotlin
Elixir
syntax-...
neovim-...
288 commits
# 339,679
magnet-...
Shell
C
HTML
2 commits
# 95,771
C++
Android
Kotlin
Nextclo...
2 commits
# 14,751
ip-addr...
Arch Li...
Electro...
Zsh
1 commit
# 33,143
Symfony
gtk
messeng...
videoga...
1 commit

flashfocus

Simple focus animations for tiling window managers.

Demo gif


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

Flashfocus is currently pretty stable and I don't have any major features in the works, however the project is still actively maintained and feature requests are always welcome :)

Installation

For X based window managers, an active window compositor is required for the effects of flashfocus to be noticeable. If you don't have one setup already, I recommend picom.

Arch

Install from the Arch User Repository:

flashfocus-git

Ubuntu/Debian

sudo apt-get install libxcb-render0-dev libffi-dev python-dev python-cffi
pip install flashfocus

Fedora

dnf install libffi-devel python-devel python-cffi
pip install flashfocus

openSUSE

Flashfocus is in the official repository of openSUSE Tumbleweed. openSUSE Leap users can install it from the X11:Utilities devel project:

zypper ar obs://X11:Utilities x11util
zypper ref
zypper in flashfocus

Nix / NixOS

Declaratively in

/etc/nixos/configuration.nix
environment.systemPackages = with pkgs; [
  flashfocus
];

Ad hoc

nix-env -iA nixpkgs.flashfocus

Quickstart

Picom setup

The following must be present in your picom config file:

detect-client-opacity = true;

If you use i3, the following is also required for flashfocus to work with tabbed containers:

opacity-rule = [
  "0:[email protected]:32a *= '_NET_WM_STATE_HIDDEN'"
];

Running flashfocus

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

exec_always --no-startup-id flashfocus

The

flash_window
script can be used to flash the current window on key-press. E.g if you'd like to bind to mod+n in i3:
bindsym $mod+n exec --no-startup-id flash_window

Configuration

Flashfocus can be configured via its config file or with command line parameters. Some features, such as window-specific flash customization, are only available through the config file.

The config file is searched for in the following locations: 1. $XDGCONFIGHOME/flashfocus/flashfocus.yml 2. ~/.config/flashfocus/flashfocus.yml 3. ~/.flashfocus.yml

When flashfocus is first run it creates a default config file in 1. or 2. Documentation of all configuration options is present in the config file.

See the wiki for some extra docs.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.