Skip to main content

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!

✨🍰✨

Metadata

Release files for em-keyboard 5.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for em-keyboard 5.4.0
File Size Uploaded
em_keyboard-5.4.0.tar.gz 61.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for em-keyboard 5.4.0
File Interpreter ABI Platform
em_keyboard-5.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 118.1 kB

Release files / em_keyboard-5.4.0.tar.gz

Download URL em_keyboard-5.4.0.tar.gz
Size 61.9 kB
Tags Source
SHA-256 checksum
How to use checksums
51a675b91cd958ea9307d71f59898ba737a1312f3ca33abfdcb8a73b7ade9d64
BLAKE2b-256 checksum
How to use checksums
c6e1baba3f8c6f88f7c60cdf37fb25e670ceb8fd02f4ae01044c717f0e581f6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 24, 2026.

Transparency log

Release files / em_keyboard-5.4.0-py3-none-any.whl

Download URL em_keyboard-5.4.0-py3-none-any.whl
Size 56.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f710338211aff4835ea39d391d82f3f8b9e28be84828dd11d378b5829ae311aa
BLAKE2b-256 checksum
How to use checksums
d26584aed5b90979809b8a7e2224d792960cc5a0719799a2b8050253cee7a5bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 24, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

5.4.0 This release

2 release files

5.3.0

2 release files

5.2.0

2 release files

5.1.0

2 release files

5.0.1

2 release files

5.0.0

2 release files

4.5.0

2 release files

4.4.0

2 release files

4.3.0

2 release files

4.2.0

2 release files

4.1.0

2 release files

4.0.0

2 release files

3.9.0

2 release files

3.8.0

2 release files

3.7.0

2 release files

3.6.0

2 release files

3.5.0

2 release files

3.4.0

2 release files

3.3.0

2 release files

3.2.0

2 release files

3.1.0

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.7

1 release file

0.0.6

1 release file

0.0.5

1 release file

0.0.4

1 release file

0.0.3

1 release file

0.0.2

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page