Terminal based emoji chooser πŸ’» πŸ€“
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tuimoji
.gitignore
LICENSE
README.md
setup.py

README.md

tuimoji

tuimoji is a terminal based emoji chooser for *nix. With tuimoji you can search and browse emojis and copy them to your clipboard without ever leaving the comfort of your terminal!

Tuimoji main window

Here is an asciicast of tuimoji in action

Features

Installation

tuimoji requires Python3 and xclip to be installed. xclip can be installed via your favorite package manager (if it is not already).

To install tuimoji, use pip:

pip3 install --user tuimoji

Arch Linux

tuimoji is available in the AUR and can be installed via makepkg or with your favorite AUR helper:

yay -S tuimoji

Usage

Launch tuimoji with the tuimoji command. By default, the search input is focused, allowing you to type to search immediately:

Tuimoji search

Press Enter to highlight the first result, and use the cursor keys to navigate to the desired emoji. Pressing Enter again will copy the emoji to your clipboard and exit the program.

Alternatively you may browse emojis using the named categories. Use the cursor keys to navigate and press Enter to select a category.

Skin tone modifier

tuimoji defaults to 0 which is the original Simpsons skin tone (no modifier).

To change the tone launch tuimoji with the -t or --tone command line argument:

tuimoji -t 6

The available skin tone modifiers are:

Tone Result
0 πŸ‘Š
1_2 πŸ‘ŠπŸ»
3 πŸ‘ŠπŸΌ
4 πŸ‘ŠπŸ½
5 πŸ‘ŠπŸΎ
6 πŸ‘ŠπŸΏ

Change the clipboard

By default tuimoji will copy characters to the clipboard, which is the usual selection when using copy and paste operations (ctrl+c/ctrl+v). You can also tell tuimoji to place the character on the primary (middle click paste) or secondary (unused?) selections.

Launch tuimoji with the -s or --selection command line argument:

tuimoji -s primary

Acknowledgements

Thanks to shanraisshan/EmojiCodeSheet for the contents of the .json data file in this project.