kendra

Kendra (केन्द्र) is Sanskrit for "centre": the centre every quick setting sits in.

kendra is quick settings 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 the theme / wallpaper / caffeine capsules on the bar.

#Features

• A panel under the bar's top-right corner: a greeting, uptime and battery, lock and power buttons.
• Tiles: Wi‑Fi, Bluetooth, hotspot, do not disturb, caffeine, dark theme, new wallpaper, power profile, each saying what it's doing; right click / Shift+Enter opens a tile's details.
• Volume and brightness sliders (click the speaker to mute).
• Opens instantly with the last state, then refreshes every tile in the background; anything the machine doesn't have isn't shown.
• Any tile can be driven by your own commands (status / toggle / on / off, matched with on_when).
• 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.4 or newer (Python 3.11+, PyGObject, GTK 4, gtk4-layer-shell, a Nerd Font)
• optional: nmcli, bluetoothctl, makoctl, gsettings, powerprofilesctl, wpctl, brightnessctl (each tile uses what's there)

#Install

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

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

bindsym $mod+<key> exec vyom kendra

#Update and uninstall

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

#Usage

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

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.kendra]:

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:

#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.