emocli provides a command-line interface for searching emoji characters.
Usage: emocli [OPTIONS] <search> OPTIONS: -h | --help print this help -l | --list list all emoji characters -i | --info include info -n | --name match name exactly --version print version and exit
list all emoji characters with their name, info, and gitmoji description (if available)
search for an emoji using keywords
# output | & | | & | | & | | & | | & | | & |
print a specific emoji by name
if the name is more than one word, it should be enclosed in quotes
use in a commit message
git commit -m "$(emocli -n rocket) production launch"
use with rofi and xclip
rofi is a window switcher, application launcher, and dmenu replacement. Here, it is being used as a dmenu replacement to provide a graphical interface for search and select.
xclip is a command line utility that provides an interface to the X11 clipboard. Here, it is being used to copy its standard input into the clipboard.
# put this somewhere as a script in your PATH, shell alias, or keyboard shortcut | | | |
my terminal is not displaying all emoji characters
Your mileage may vary on terminal support for displaying emoji consisting of 2 or more characters joined by a zero-width joiner character (U+200D). The "service dog" emoji (🐕🦺) is one such example. Even with a proper font config, it will appear on many terminals as a dog next to a safety vest (🐕🦺).
This software is released under the MIT License. See
LICENSE for details.
This software includes source files from third party components, Gitmoji and Unicode CLDR. Each of these components have their own license. See
Pull requests are welcome at https://github.com/duhdugg/emocli/pulls
Submit issues at https://github.com/duhdugg/emocli/issues