dmoji

A Linux tool using dmenu to select an emoji and copy it to clipboard. A text file with additional more complex emojis sequences or ASCII arts can be provided via a command line option. Unlike some other similar tools, dmoji does not use a static text file of emojis : the list is built on the fly straight from the ICU library.

Requirements

ICU library and headers
xsel : to copy data to clipboard
A dynamic menu for X (dmenu and rofi are currently supported)

Compile

Ensure that you have libicu libraries & headers, as well as xsel & dmenu.

On a Fedora based machine :

$ sudo dnf install libicu libicu-devel dmenu xsel

On a Arch Linux based machine :

$ sudo pacman -S icu dmenu xsel

Compile

$ make

Have a try

3.a) with dmenu

$ ./dmoji

3.b) with rofi

$ ./dmoji -r

Then choose an emoji and paste it in a text file.

Also use the static ASCII arts file

$ ./dmoji -a ./additional-entries/ascii-arts.txt

Since the additional entries contain 'ASCII' as part of their description, type 'ascii' in dmenu to filter them.

To install it in /usr/local/bin

$ sudo make install

How to use it

Via the command line

$ ./dmoji -h
dmoji version: 0.3-1-g4a6a62e, git 4a6a62e197279c0b2320124456c53af1d6809ab2

Calls dmenu with a list of all base emojis available from the ICU library, then copies the selected emoji to clipboard
Options:
 -r             Use Rofi instead of dmenu (Rofi will be started in dmenu mode)
 -a <file>      File containing additional data (e.g.: ASCII arts, or more complex Unicode sequences)
                Anything after the separator will be discarded before being sent to the clipboard


Additional data file:
* Each line represents a new entry: the part to be copied, optionally followed by a separator (' ;') and a description to help the search
* Lines starting with a space (i.e.: ' ') are ignored as comments

Via a Window Manager shortcut

Generally, you want to add a shortcut in your Window Manager to launch it. For example, in the i3 Window Manager :

bindsym $mod+Mod1+e exec --no-startup-id dmoji

You will be presented with a list of emoji (character and name) supported by the ICU library. You can then use standard dmenu method to reduce and select a desire emoji and copy it to the clipboard.

vaygr / dmoji