a very lightweight popup dictionary written in C
Go to file
2024-02-05 10:19:13 -04:00
misc Add files via upload 2023-08-06 15:19:04 -04:00
config.def.h Improve html dictionaries 2023-05-28 13:15:50 +02:00
config.mk Update Makefile 2023-05-10 19:47:42 +02:00
daemon-popup Update daemon-popup 2023-06-02 16:37:28 -04:00
dictpopup Update dictpopup 2023-08-06 14:18:21 -04:00
format_output.c Improve formatting 2023-05-28 21:04:04 +02:00
LICENSE Update LICENSE 2024-01-15 22:52:58 -04:00
Makefile Improve html dictionaries 2023-05-28 13:15:50 +02:00
popup.c Update popup.c 2023-06-02 11:16:48 -04:00
README.md Update README.md 2024-02-05 10:19:13 -04:00

suckless_dictpopup

This is a very lightweight program to show a popup with the dictionary entry of the selected text. It uses Xlib for displaying the popup and sdcv for the dictionary lookup.

DISCLAIMER: That program is intended to be used for reading monolingual dictionaries in goldendict-ng , it can serve others purposes, but the main goal is that you don't need to wait years until you complete your monolingual transition.

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

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.
  • Clipboard watch toggle