A simple emoji picker for rofi with multi-selection
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Kabouik c419be88d5
Update readme.
1 year ago
.gitignore Add temp file to gitignore 1 year ago
CHANGELOG.md Support alternative emoji lists 1 year ago
LICENSE Update license 2 years ago
README.md Update readme. 1 year ago
extract_emojis.py Format the annotations to be less obtrusive 1 year ago
font-awesome.txt Added unicode characters. 1 year ago
requirements-dev.txt Update dependencies and emojis 1 year ago
rofimoji.py Change default text in search field. 1 year ago
screenshot-fork.png Update screenshot. 1 year ago
screenshot.png Update screenshot 1 year ago
unicode.txt Added unicode characters. 1 year ago


rofimoji (an emoji picker for rofi) with unicode search

This repository is a fork of rofimoji by fdw with the addition of unicode characters from /u/fe80c0ffee. Unicode characters are sorted to be shown first when invoking rofimoji. A .txt file with Awesome font from /u/Delearyus is supplied too, but not included by default; one can just copy/paste its content into rofimoji.py between emoji_list = """ and """.

Recommended command line to run rofimoji from a keybinding:

python3 /path/to/rofimoji/rofimoji.py -s ask --rofi-args="-columns 2; -width 50%; -no-click-to-exit; -theme sidebar"

Screenshot of rofimoji-fork

The theme used in the above screenshot is sidebar by qball, which can be selected as default using rofi-theme-selector in terminal.

Original README from fdw:

How often did you want to insert one of those Unicode emoji only to learn that there is no nice picker for Linux? Fear no more, this script uses the power of rofi to present exactly the picker you always wanted. Inserts the selected emoji directly, or copies it to the clipboard.


  1. Run rofimoji.py
  2. Search for the emoji you want
  3. (optional) Select multiple emoji with shift+enter
  4. Hit enter to insert the emoji directly \ Hit alt+c to copy it to the clipboard \ alt+t or alt+p can be used to select a specific input method
  5. Maybe select a skin color
  6. 🎠

How does it look?

Screenshot of rofimoji

Insertion method

For some applications, xdotool cannot type emojis (f.e. Firefox). To work around this, rofimoji can copy the emojis to your clipboard and insert them from there with shift+insert. Afterwards, it will restore the previous contents. Unfortunately, it depends on the receiving application whether shift+insert uses the clipboard or the primary selection. Therefore, rofimoji uses both and also restores both 😐.

By default, rofimoji uses xdotool type. To choose to spam your clipboards, you can either use the keybinding alt+p or start it as rofimoji --use-clipboard (-c). If you want to use typing, you can hit alt+t, even though it was started with --use-clipboard.


You can choose a skin tone with the --skin-tone (or -s) parameter. The available values are light, medium-light, moderate, dark brown, black, as well as neutral and ask to be shown the prompt (this is also the default).

If you have any arguments for rofi, you can make rofimoji pass them through like this: rofimoji --rofi-args="-columns 3".

You can also define your own set of emojis (or whatever) and use rofimoji to pick them by providing the --emoji-file (-f) parameter. This could be helpful if you want them ordered in some way, only use a subset or if you want non-English descriptions.



A kind soul has packaged it as rofimoji. To, install, use sudo pacman -Syu rofimoji.

From sources

Download rofimoji.py and move it somewhere on your path, for example /usr/local/bin.

What else do you need:

  • Python 3
  • A font that can display emoji, for example EmojiOne or Noto Emoji
  • xdotool for typing the emoji
  • xsel to copy the emoji to the clipboard

For Ubuntu zesty: sudo aptitude install fonts-emojione python3 rofi xdotool xsel \ For Arch: sudo pacman -Syu emoji-font python rofi xdotool xsel

Updating the emojis

This is only needed if a new Unicode version came out and you can’t wait for the official update!

  1. Install Python 3 and pip install -r requirements-dev.txt
  2. Run extract_emojis.py - this downloads the complete list from https://unicode.org/emoji/charts-12.0/full-emoji-list.html, so don’t do it too often!
  3. A new file emojis.py should have been created. Open it and copy the contents
  4. Open rofimoji.py and replace the emoji list with the contents of emojis.py


Why is it so pedestrian? Why not simply import from emojis.py?

Because now you only have to download one file, and it works  Additionally, we need no separate I/O just to load the emojis. This is good, right?