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
🌼  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

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.2.0.tar.gz (60.6 kB view details)

Uploaded Source

Built Distribution

em_keyboard-5.2.0-py3-none-any.whl (55.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for em_keyboard-5.2.0.tar.gz
Algorithm Hash digest
SHA256 d97debae44506a177dbab50bd755945eaa426e133fe90fd659f865afda0e29c8
MD5 6e99e8e1db744454347bdda450a57d67
BLAKE2b-256 be26f177880200eaecbd14be841dd32a9d30b14a598317a5e7a22bdd39a5589b

See more details on using hashes here.

Provenance

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

File metadata

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

File hashes

Hashes for em_keyboard-5.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9368788f8f1be2c2100b6f098ed6f57bdbb783776a7770161cbb54e185c67bab
MD5 b2c5c1f7a2d9af65ede8b7484cd118d1
BLAKE2b-256 6f8a69b0ef9d853273b9f7e1ba1d3faf3a4be301eeb0131315036c2736ce16ea

See more details on using hashes here.

Provenance

The following attestation bundles were made for em_keyboard-5.2.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 Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page