Skip to main content

The CLI Emoji Keyboard

Project description

em: the cli emoji keyboard

PyPI version Supported Python versions PyPI downloads GitHub Actions status Codecov Licence Code style: Black

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
👩  woman
🐤  baby_chick
🐠  tropical_fish
🌻  sunflower
🌼  blossom
🚧  construction
🌕  full_moon
⭐  star
📒  ledger
🚸  children_crossing
🔰  japanese_symbol_for_beginner
🟡  yellow_circle
🟨  yellow_square
🫚  ginger_root

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

$ em -s ukraine
Copied! 🇺🇦  flag_ukraine

Pick a random emoji:

$ em --random
Copied! 💤  zzz

Pick a random emoji:

$ em --search yellow --random
Copied! 🟨  yellow_square

Installation

At this time, em requires Python and pip:

python3 -m pip install em-keyboard

On Linux, an additional dependency is required for automatic copying to clipboard. This would be either xclip in an X11 session or wl-clipboard in a Wayland session. On a Debian-based distribution these are installable with:

sudo apt install xclip
sudo apt install wl-clipboard

Tests

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

python3 -m pip install tox
tox

Have fun!

✨🍰✨

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

em_keyboard-5.3.0.tar.gz (61.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

em_keyboard-5.3.0-py3-none-any.whl (55.3 kB view details)

Uploaded Python 3

File details

Details for the file em_keyboard-5.3.0.tar.gz.

File metadata

  • Download URL: em_keyboard-5.3.0.tar.gz
  • Upload date:
  • Size: 61.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for em_keyboard-5.3.0.tar.gz
Algorithm Hash digest
SHA256 0ddbc8e950fec5c074b503deb7c816fb75bb6ec599f7a48e9b32ca222575fc6f
MD5 22e4a6c48e4e257cddb311da63193c7d
BLAKE2b-256 c59bd4abb30eab5e47a45074123ebd05e933fa7cbfad610b0a3a5a9844095c37

See more details on using hashes here.

Provenance

The following attestation bundles were made for em_keyboard-5.3.0.tar.gz:

Publisher: deploy.yml on hugovk/em-keyboard

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file em_keyboard-5.3.0-py3-none-any.whl.

File metadata

  • Download URL: em_keyboard-5.3.0-py3-none-any.whl
  • Upload date:
  • Size: 55.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for em_keyboard-5.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3519ca984c982c1417cdb766fb8d008db236084984727e982572fa4fac82c990
MD5 ac42c22ef28bfe7762984d73e72dba1f
BLAKE2b-256 7acad2fb48540efdae040a14ea577619675ffdc834a347f209a082926753054a

See more details on using hashes here.

Provenance

The following attestation bundles were made for em_keyboard-5.3.0-py3-none-any.whl:

Publisher: deploy.yml on hugovk/em-keyboard

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page