suckless_dictpopup/README.md
2023-06-02 16:45:30 -04:00

1.8 KiB

suckless_dictpopup

This is a very lightweight program to show a popup with the dictionary entry of the selected text. It uses sdcv for the dictionary lookup and optionally, a slightly modified version of herbe to display the popup.

image

Dependencies

notice that most of them might be already installed, they are:

sselp , sdcv, perl

Currently tested on:

  • Gnu/Linux
  • FreeBSD

Setup

First setup sdcv according to their github page. Then install with sudo make install.
Uninstall with sudo make uninstall

If you would like to automatically lookup a word on every selection (recommended) , then take a look at the following script:
https://github.com/KonstantinDjairo/suckless_dictpopup/blob/main/daemon-popup

This is not meant to be running all the time, since it looks up everything that goes into the clipboard.
Disable when using mpvacious for example.

Usage

Bind to a shortcut

To add a keyboard shortcut, you can use options of your WM or DE. You can also use sxhkd.
The popup can be dismissed by clicking on it.

Here is a snippet from my ~/.config/i3/config showing how to bind dictpopup to a keyboard shortcut.

# Run dictpopup
bindsym $mod+c          exec --no-startup-id dictpopup

The styling can be changed in config.h and then recompile to apply. There is also a xresources patch from herbe that you could try to apply if you like.

popup can also be used as a standalone program to show the contents of stdin.

TODO

  • Completed
  • Work in Progress

  • Switch between words in a given sentence by using the arrow keys or any user-defined key; Sudachi can be used to accomplish that.