vishram · Power menu: lock, suspend, log out, reboot, power off; one letter each, a 5-second countdown with cancel for the final ones.

vishram: power panel

Vishram (विश्राम) is Sanskrit for "rest": the rest at the end of a session: lock, suspend, power off.

vishram is the power menu for Vyom: one keyboard-driven panel that opens instantly, with live data, a preview and a key for everything. It runs on any compositor with the layer-shell protocol (sway, Hyprland, river, niri, Wayfire, labwc…). In Vayu, the desktop it was built for, it replaces nwg-bar.

#Features

Lock, suspend, log out, reboot and power off, one letter each (L S E R P).
Log out, reboot and power off count down 5 seconds first (Esc cancels, Enter does it now), showing how many windows are still open.
Log out works on sway, Hyprland and niri out of the box (else loginctl terminate-session).
Keyboard first: every action has a key, shown in the footer; the mouse works too.
Never freezes the panel: slow commands run in the background.

#Install

#Requirements

Vyom 0.2.6 or newer (Python 3.11+, PyGObject, GTK 4, gtk4-layer-shell, a Nerd Font)

#Install

git clone https://github.com/Theyashsawarkar/vishram ~/.local/share/vyom/plugins/vishram
vyom reload           # pick it up (or log out and in)
vyom vishram            # open it; run it again to close

Give it a key in your compositor, e.g. sway:

bindsym $mod+<key> exec vyom vishram

#Update and uninstall

git -C ~/.local/share/vyom/plugins/vishram pull && vyom reload     # update
rm -rf ~/.local/share/vyom/plugins/vishram && vyom reload          # uninstall

#Usage

Open it with vyom vishram (or your key). Type to search; the footer always shows the keys for what's selected.

Key	Action
`L`	Lock the screen
`S`	Suspend
`E`	Log out (after a 5-second countdown)
`R`	Reboot (after a 5-second countdown)
`P`	Power off (after a 5-second countdown)
`Enter (counting down)`	Do it now instead of waiting
`Esc (counting down)`	Cancel the countdown
`Esc`	Close the panel

Every Vyom panel also has Up/Down (or Ctrl+K/Ctrl+J) to move, Page Up/Page Down to jump and Tab to switch to the next tool.

#Configuration

Everything is optional, in ~/.config/vyom/config.toml under [plugin.vishram]:

Setting	Default	What it does
`lock / suspend / logout / reboot / poweroff`	loginctl lock-session, systemctl …	The command for each
`countdown`	5	Seconds before log out / reboot / power off

Run vyom reload after editing.

#Troubleshooting

Nothing opens. vyom list shows every installed tool, and why one is skipped (a missing requirement, or a Vyom that's too old).
It opened, then something failed. Look for a Traceback in ~/.local/state/vyom/daemon.log, and open an issue with it.
No blur or rounded corners. That's the compositor: on SwayFX, add layer_effects "vyom" { blur enable; corner_radius 20; shadows enable }.

#The Vyom family

Each tool is its own repository, so you install only the ones you want:

Tool		What it does
dvara	द्वार, gateway	The app launcher
ganit	गणित, mathematics	The calculator and converter
smriti	स्मृति, memory	Clipboard history
bhava	भाव, feeling, emotion	The emoji picker
tarang	तरंग, wave	Wi‑Fi and the hotspot
setu	सेतु, bridge	Bluetooth
doot	दूत, messenger	Your phone, through KDE Connect
patra	पात्र, vessel	Docker containers
suchana	सूचना, notice	Notifications
raga	राग, melody	YouTube music and video
mudra	मुद्रा, gesture	Keybinding search
urja	ऊर्जा, energy	The battery at a glance
vishram (this one)	विश्राम, rest	The power menu
kendra	केन्द्र, centre	Quick settings

#Contributing

Bug reports, ideas and pull requests are welcome: see CONTRIBUTING.md for the development setup and the few rules every tool follows, and CHANGELOG.md for what changed in each release. Please report security issues privately (SECURITY.md).

#License

MIT.