Hyprland plugin for temporarily toggling top layer plugins above fullscreen windows.
  • C++ 79.6%
  • Meson 11.4%
  • CMake 6.4%
  • Makefile 2.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-01-01 20:41:09 +05:45
.clang-format init: file uploads 2025-08-22 12:23:52 +05:45
.gitignore Initial commit 2025-08-22 12:13:10 +05:45
CMakeLists.txt init: file uploads 2025-08-22 12:23:52 +05:45
globals.hpp init: file uploads 2025-08-22 12:23:52 +05:45
hyprpm.toml hyprpm: update pin to 0.53.0 2026-01-01 20:41:09 +05:45
LICENSE Initial commit 2025-08-22 12:13:10 +05:45
main.cpp Merge pull request #2 from nnra6864/40d8fa8-fixes 2026-01-01 20:32:17 +05:45
Makefile init: file uploads 2025-08-22 12:23:52 +05:45
meson.build init: file uploads 2025-08-22 12:23:52 +05:45
README.md Add reset dispatcher 2025-12-12 19:10:44 +05:45

hyprtoplr

Top Layer visibility plugin for Hyprland. Adds some top layer visibility dispatchers to Hyprland. [mainly with fullscreen]

https://github.com/user-attachments/assets/5c054224-4a0a-459e-9fb1-fcb9b82fdaf5

Installation

Through hyprpm

hyprpm add https://github.com/SsubezZ/hyprtoplr
hyprpm enable hyprtoplr
hyprpm reload

Manual

git clone https://github.com/SsubezZ/hyprtoplr
cd hyprtoplr
make all

hyprctl plugin load /path/to/hyprtoplr.so # should be absoulute

Dispatchers

All dispatchers here are called plugin:hytop:<name> e.g. plugin:hytop:toggle.

Name Description Usage
show Forces top layers to be visible, regardless of workspace fullscreen state. hyprctl dispatch plugin:hytay:show
hide Forces top layers to be hidden, regardless of workspace fullscreen state. hyprctl dispatch plugin:hytay:hide
toggle Toggles top layers visibility, but respects fullscreen rules of the active or special workspace. hyprctl dispatch plugin:hytay:toggle
justtoggle Toggles top layers visibility unconditionally, ignoring workspace and fullscreen rules. hyprctl dispatch plugin:hytay:justtoggle
reset Resets the state of the visibilty. hyprctl dispatch plugin:hytay:reset

Usage

Toggle with swaync to avoid awkward empty area on the top

bind = WIN, Z, plugin:hytop:toggle
bind = WIN, Z, exec, swaync-client -t
Before After
before after

Close swaync and hide the layer

bind = WIN SHIFT, Z, exec, swaync-client -cp
bind = WIN SHIFT, Z, plugin:hytop:hide