mirror/hyprland-plugins
3
0
Fork 0
mirror of https://github.com/hyprwm/hyprland-plugins.git synced 2026-08-18 11:14:01 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
f2aa5984d58df44872c81e6c2d997670a38ff236
hyprland-plugins/hyprfocus/README.md
Steven Merino 1f90c674d5 hyprfocus: add granular focus animation control (#678) 
Replace the single `mode` option with separate `keyboard_focus_animation`
and `mouse_focus_animation` settings, leveraging `Desktop::eFocusReason`
to distinguish focus source. This allows different effects (or none) for
keyboard vs mouse focus changes.

New config options:
- `enable` — toggle the plugin on/off
- `animate_floating` — control whether floating windows animate
- `keyboard_focus_animation` — animation for keyboard focus (default: flash)
- `mouse_focus_animation` — animation for mouse focus (default: none)

Renamed `bounce` → `shrink` and `bounce_strength` → `shrink_percentage`
for clarity. Preserves existing `only_on_monitor_change`, `fade_opacity`,
and `slide_height` options.
2026-06-14 14:13:25 +01:00

1.4 KiB
Raw Blame History

hyprfocus

Flashfocus for Hyprland.

Configuring

Animations

Hyprfocus exposes two animation leaves: hyprfocusIn and hyprfocusOut:

animation = hyprfocusIn, 1, 1.7, myCurve
animation = hyprfocusOut, 1, 1.7, myCurve2

Variables

name description type default
enable enable or disable the plugin bool true
animate_floating animate floating windows bool true
only_on_monitor_change whether to only perform the animation when changing between monitors bool false
keyboard_focus_animation animation for keyboard-driven focus changes (flash / shrink / slide / none) str flash
mouse_focus_animation animation for mouse-driven focus changes (flash / shrink / slide / none) str none
fade_opacity for flash, opacity at the peak of the animation float 0.8
shrink_percentage for shrink, fraction of the window size to scale to at the peak float 0.95
slide_height for slide, how many pixels to slide upward float 20