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.

README.md 2.0KB

1 year ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. # Emoji-Picker
  2. How often did you want to insert one of those Unicode emoji only to learn that there is no nice picker for Linux?
  3. Fear no more, this script uses the power of [rofi](https://github.com/DaveDavenport/rofi/) to present exactly the picker you always wanted.
  4. Inserts the selected emoji directly, or copies it to the clipboard.
  5. ## Usage
  6. 1. Run `rofimoji.py`
  7. 2. Search for the emoji you want
  8. 3. (optional) Select multiple emoji with `alt+enter`
  9. 4. - Hit `enter` to insert the emoji directly
  10. - Hit `alt+c` to copy it to the clipboard
  11. 5. Maybe select a skin color
  12. 6. 🎠
  13. ## How does it look?
  14. ![Screenshot of rofimoji](screenshot.png?raw=true)
  15. ## Installation
  16. ### Arch & Manjaro
  17. A kind soul has packaged it as [rofimoji-git](https://aur.archlinux.org/packages/rofimoji-git/). To, install, use `yaourt -S rofimoji-git`.
  18. ### From sources
  19. Download `rofimoji.py` and move it somewhere on your path, for example `/usr/local/bin`.
  20. What else do you need:
  21. - Python 3
  22. - A font that can display emoji, for example [EmojiOne](https://github.com/emojione/emojione) or [Noto Emoji](https://www.google.com/get/noto/)
  23. - xdotool for typing the emoji
  24. - xsel to copy the emoji to the clipboard
  25. For Ubuntu zesty: `sudo aptitude install python3 fonts-emojione xsel xdotool`
  26. For Arch/Manjaro: `yay -S python ttf-emojione-color xsel xdotool`
  27. ## Updating the emojis
  28. This is only needed if a new Unicode version came out and you can't wait for the official update!
  29. 1. Install Python 3 and `pip install -r requirements-dev.txt`
  30. 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!
  31. 3. A new file `emojis.py` should have been created. Open it and copy the contents
  32. 4. Open `rofimoji.py` and replace the emoji list with the contents of `emojis.py`
  33. ## FAQ
  34. ### Why is it so pedestrian? Why not simply import from `emojis.py`?
  35. Because now you only have to download one file, and it works 
  36. Additionally, we need no separate I/O just to load the emojis. This is good, right?