/em-keyboard-py3

the cli emoji keyboard™

Primary LanguagePythonISC LicenseISC

em: the cli emoji keyboard™

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.

Screenshot of em command-line interface.

Example Usage

Let's serve some delicious cake:

$ em sparkles cake sparkles
Copied! ✨🍰✨

Let's skip the copying (for scripts):

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

Let's find some emoji, by color:

$ em -s red
🚗  car
🎴  flower_playing_cards
👹  japanese_ogre
👺  japanese_goblin

Let's get a random emoji:

$ em -r
Chosen: books
Copied! 📚

$ em -r 3
Chosen: stars cd cloud_with_lightning_and_rain
Copied! 🌠 💿 ⛈

Installation

At this time, em requires Python and pip:

$ pip install em-keyboard-py3

That's it!

Have fun!

✨🍰✨

Notes

Running this command will also install the Python package Xerox, which may have dependencies on your system. See the Xerox repo for more information.

Why This Repo and Not The Original?

Python 3 support has been broken for almost 2 years. It's been fixed in the repo but for some reason a new version haven't been released for it. This is to fill the gap; should em get updated this will go away.