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.

Dependencies

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

sselp , sdcv, perl

By using Perl one-liners, we are able to replace the usage of awk, grep, and sed with Perl equivalents, making the code more consistent and eliminating the need for external tools.

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 someone's ~/.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.

Recommended fonts

For low-resolution monitors i recommend that font:

source-han-code-jp
in this picture the font is set at 10px

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.

2.4 KiB Raw Blame History