suchana · Notifications (mako): what's on screen with its actions, the history grouped by app, a full preview, do not disturb.

Suchana (सूचना) is Sanskrit for "notice": the notices your apps send you.

suchana is notifications 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 notification-history.py.

#Features

What's on screen now, with the actions it offers (run them, or dismiss it).
The history, grouped by app, newest first, with each app's icon; urgent ones flagged.
The preview shows the whole message.
A do not disturb switch (mako's do-not-disturb mode, or your own commands).
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.5 or newer (Python 3.11+, PyGObject, GTK 4, gtk4-layer-shell, a Nerd Font)
makoctl

#Install

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

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

bindsym $mod+<key> exec vyom suchana

#Update and uninstall

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

#Usage

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

Key	Action
`Enter`	Run the notification's default action, or copy its text
`Ctrl+C`	Copy the notification's text
`Ctrl+Backspace`	Dismiss the on-screen notification
`Ctrl+N`	Turn do not disturb on or off
`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.suchana]:

Setting	Default	What it does
`dnd_status`	(makoctl mode)	Command printing the current mode
`dnd_on_when`	^dnd$	Regex: do not disturb is on
`dnd_on / dnd_off`	(makoctl mode -a/-r)	Commands to turn it on / 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 (this one)	सूचना, notice	Notifications
raga	राग, melody	YouTube music and video
mudra	मुद्रा, gesture	Keybinding search
urja	ऊर्जा, energy	The battery at a glance
vishram	विश्राम, 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.