Plugins and version dependencies
Why hyprbars, hyprdrag and native modules have to match the system version.
On this page
What the plugins add
hyprbars adds title bars. The project version contains its own hover areas and the color of inactive bars. hyprdrag reports move and resize interactions to the interface for the snap preview.
Why an update can require a rebuild
Hyprland plugins use internal interfaces of the compositor. A build therefore has to match the actual target packages. The packaging ties the plugins to the Hyprland and libstdc++ versions in use, and the terminal module to Qt and qtermwidget.
A message such as Version mismatch should be solved with a matching rebuild or a matching package set. Bypassing the version check does not produce a compatible build.
Check what is loaded
In a running Hyprland session, this read-only command lists the loaded plugins:
hyprctl plugin list
Make sure you do not also load a second, unpatched hyprbars version through another plugin manager. The project features require the matching build.
As of 9 November 2026 · This help describes version 0.1.0-27. Individual features and labels may change.
← More help topicsReport a problem →