Skip to content

Latest commit

 

History

History
96 lines (66 loc) · 2.19 KB

README.md

File metadata and controls

96 lines (66 loc) · 2.19 KB

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!

✨🍰✨