Skip to content

hugovk/em-keyboard

Repository files navigation

em: the cli emoji keyboard™

PyPI version Supported Python versions PyPI downloads GitHub Actions status codecov GitHub

Emoji your friends and colleagues from the comfort of your own terminal.

em is a nifty command-line utility for referencing emoji characters by name. Provide the names of a few emoji, and those lucky chosen emojis will be displayed in your terminal, then copied to your clipboard. Automagically.

Emoji can be also searched by both categories and aspects.

Example Usage

Let's serve some delicious cake:

$ em sparkles shortcake sparkles
Copied! ✨ 🍰 ✨

Let's skip the copying (for scripts):

$ em 'chocolate bar' --no-copy
🍫

Let's find some emoji, by color:

$ em -s yellow
💛  yellow_heart
🌼  blossom
🌕  full_moon
⭐  star
🚸  children_crossing
🟡  yellow_circle
🟨  yellow_square

If there's only a single search result, it's copied:

$ em -s ukraine
Copied! 🇺🇦  flag_ukraine

Installation

At this time, em requires Python and pip:

python3 -m pip install em-keyboard

That's it!

Tests

If you wanna develop, you might want to write and run tests:

python3 -m pip install tox
tox

Have fun!

✨🍰✨