hyprpwr 0.1.0

A simple GTK power menu styled after hyprland.

HyprPwr

A minimal power/session menu for Hyprland written in Python and GTK3.

HyprPwr provides a small keyboard-friendly popup for common session management actions:

• Logout
• Shutdown
• Restart
• Suspend

Features

• Lightweight GTK3 interface
• Keyboard navigation (↑/↓, j/k)
• Mouse support
• Clean floating window design
• Designed specifically for Hyprland
• No external menu launcher required

Requirements

• Python 3
• GTK3
• PyGObject
• Hyprland

Dependencies

Runtime Dependencies

Dependency	Purpose
Python 3.8+	Application runtime
GTK 3	User interface
PyGObject	Python GTK bindings
Hyprland	Session management integration
systemd	Shutdown, reboot, and suspend actions

Distribution Packages

Arch Linux

sudo pacman -S python python-gobject gtk3

Debian / Ubuntu

sudo apt install python3 python3-gi gir1.2-gtk-3.0

Fedora

sudo dnf install python3 python3-gobject gtk3

openSUSE

sudo zypper install python3-gobject gtk3

Gentoo

sudo emerge dev-python/pygobject x11-libs/gtk+

Support Matrix

Component	Status
Hyprland	✅ Supported
GTK 3	✅ Supported
Wayland	✅ Supported
X11	⚠️ Untested
systemd	✅ Supported
elogind	⚠️ Suspend/Reboot may require customization
seatd	⚠️ Untested

Distribution Support

Distribution	Status
Arch Linux	✅ Tested
EndeavourOS	✅ Expected to work
CachyOS	✅ Expected to work
Manjaro	✅ Expected to work
Fedora	✅ Expected to work
openSUSE Tumbleweed	✅ Expected to work
Debian 12+	✅ Expected to work
Ubuntu 22.04+	✅ Expected to work
NixOS	⚠️ Untested
Alpine Linux	❌ Not supported (no systemd)

Notes

• Logout functionality requires hyprctl.
• Shutdown, reboot, and suspend functionality require systemctl.
• The application is intended for Hyprland sessions and has not been tested on other Wayland compositors.
• Running as a normal user is recommended.

Installation

Make the script executable:

git clone https://github.com/jacobjuneau6/hyprpwr
cd hyprpwr
chmod +x hyprpwr.py

Optionally install it system-wide:

sudo install -Dm755 hyprpwr.py /usr/local/bin/hyprpwr

Usage

Run:

hyprpwr

or

python3 hyprpwr.py

Keyboard Controls

Key	Action
Up / k	Move selection up
Down / j	Move selection down
Enter	Execute selected action
Space	Execute selected action
Esc	Close menu

Available Actions

Action	Command
Logout	hyprctl dispatch exit
Shutdown	systemctl poweroff
Restart	systemctl reboot
Suspend	systemctl suspend

Hyprland Binding

Example keybind for launching HyprPwr:

bind = SUPER, X, exec, hyprpwr