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.4.0.tar.gz (61.9 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.4.0-py3-none-any.whl (56.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for em_keyboard-5.4.0.tar.gz
Algorithm Hash digest
SHA256 51a675b91cd958ea9307d71f59898ba737a1312f3ca33abfdcb8a73b7ade9d64
MD5 07a0344e9ea72e9e469e90c28c00ad66
BLAKE2b-256 c6e1baba3f8c6f88f7c60cdf37fb25e670ceb8fd02f4ae01044c717f0e581f6b

See more details on using hashes here.

Provenance

The following attestation bundles were made for em_keyboard-5.4.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.4.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for em_keyboard-5.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f710338211aff4835ea39d391d82f3f8b9e28be84828dd11d378b5829ae311aa
MD5 bc7c7456666c8d8738a5f854e953794a
BLAKE2b-256 d26584aed5b90979809b8a7e2224d792960cc5a0719799a2b8050253cee7a5bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for em_keyboard-5.4.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