smriti · Clipboard history (cliphist): links, images, code and commands told apart, a full preview, pins, delete.

Smriti (स्मृति) is Sanskrit for "memory": everything you copied, remembered.

smriti is clipboard history 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 cliphist list | wofi --dmenu.

#Features

Your cliphist history, each entry recognised as a link, image, code, command, email or text, with a filter tab for each.
A full preview: the whole text (not cliphist's cut-off line), link domains, and images as pictures.
Enter copies; Ctrl+Enter copies and pastes into the window you were in.
Pin what you reuse (Ctrl+P); delete what shouldn't be kept (Delete).
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)
cliphist, wl-copy
optional: wtype (Ctrl+Enter paste)

#Install

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

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

bindsym $mod+<key> exec vyom smriti

#Update and uninstall

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

#Usage

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

Key	Action
`Enter`	Copy the selected entry
`Ctrl+Enter`	Copy and paste the selected entry
`Ctrl+P`	Pin or unpin the selected entry
`Delete / Ctrl+Backspace`	Delete the selected entry from the history
`Ctrl+1..5`	Show all, text, images, links or code
`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.

#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 (this one)	स्मृति, 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	विश्राम, 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.