an emoji picker compatible with linux systems using either XServer or Wayland with either Fcitx5 or IBus.
You could also say that the im in im-emoji-picker stands for input method 😉.
I'm basically using the same systems some people use to type Japanese or Chinese characters with a western keyboard.
This project took heavy inspiration from the "predecessor" https://github.com/GaZaTu/x11-emoji-picker.
Recently used emoji (EndeavourOS with KDE (XServer) and Fcitx5):
System emoji font support (openSUSE 15.1 with KDE (XServer) and IBus):
Kaomoji support (EndeavourOS with KDE (XServer) and Fcitx5):
Original Motivation (x11-emoji-picker)
I switched from Windows 10 to Linux at work and missed filling my emails with emojis. (the KDE version we use doesn't have the builtin emoji picker yet) (turns out that the KDE emoji picker only copies emojis to clipboard anyway so yea fuck that)
The issue with x11-emoji-picker is xdotool as the success rate for it to work is a lottery. Sometimes the target window requires focus to accept input; Sometimes it doesn't support XText so you need to use some hacky clipboard workaround; And sometimes it doesn't work at all. All in all a frustrating experience.
Another issue is with the x11... in the old emoji picker. I won't switch to Wayland anytime soon but having support for it in my emoji picker would've been nice so more people can use it.
Download the install.sh and run it. It downloads and installs either a .deb (Ubuntu, Debian) or a .rpm (openSUSE, Fedora).
- Terminal:
wget -q https://raw.githubusercontent.com/GaZaTu/im-emoji-picker/master/install.sh && sh install.sh - Specifying IMF:
sh install.sh -f fcitx5orsh install.sh -f ibus - Installing nightly build:
sh install.sh -r tags/nightly-build
Otherwise look at the following options:
"I use Arch btw":
run yay -S fcitx5-im-emoji-picker-git or yay -S ibus-im-emoji-picker-git.
- repo (fcitx5): https://aur.archlinux.org/packages/fcitx5-im-emoji-picker-git
- repo (ibus): https://aur.archlinux.org/packages/ibus-im-emoji-picker-git
- yay: https://github.com/Jguer/yay#installation
- manjaro: https://wiki.manjaro.org/index.php/Arch_User_Repository
Debian:
Download a -debian-*.deb from /releases and install it.
- Terminal:
sudo apt install ./im-emoji-picker-*.deb
Ubuntu:
Download a -ubuntu-*.deb from /releases and install it.
- Terminal:
sudo apt install ./im-emoji-picker-*.deb
openSUSE:
Download a -opensuse-*.rpm from /releases and install it.
- Terminal:
sudo zypper install ./im-emoji-picker-*.rpm
Fedora:
Download a -fedora-*.rpm from /releases and install it.
- Terminal:
sudo dnf install ./im-emoji-picker-*.rpm
Note: There are nightly releases aswell which are rebuilt on every push to master
After installing I'm Emoji Picker theres some steps required to make it work.
- Setup your input method framework (fcitx5 or ibus) if not already done.
- Install it
- Setup
/etc/environment - Add IMF to autostart
- Add I'm Emoji Picker to your input methods next to your keyboard language.
- Maybe configure a global shortcut with which to change the current input method and open the emoji picker.
- Advanced: you could also use the
ibusorfcitx5-remotecommands to switch the input method directly
- Advanced: you could also use the
See https://wiki.archlinux.org/title/Fcitx5.
Update your /etc/environment file to include the following snippet:
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitxCreate an autostart entry for fcitx5. (works out of the box with some DEs)
See https://wiki.archlinux.org/title/IBus.
Update your /etc/environment file to include the following snippet:
GTK_IM_MODULE=ibus
QT_IM_MODULE=ibus
XMODIFIERS=@im=ibusExecute ibus-daemon -rxR in your terminal to create an autostart entry.
Execute ibus-setup to open the IBus settings so you can add I'm Emoji Picker to your input methods and maybe change your global shortcut to change the active input method.
; The path of this file should be: $XDG_CONFIG_HOME/gazatu.xyz/im-emoji-picker.ini
; $XDG_CONFIG_HOME is usually ~/.config
; Can also be opened by pressing F4 while the emoji picker is open.
; most options require you to restart the IMF (fcitx or ibus)
[General]
; `true` = Immediately close the emoji picker after pressing enter.
; Can be done with `false` using shift+enter.
closeAfterFirstInput=false
; `true` = Only gender neutral emojis are visible (people and jobs for example)
gendersDisabled=false
; `not -1` = Any emoji released after this number is hidden
maxEmojiVersion=-1
; `true` = remember recently used kaomoji
saveKaomojiInMRU=false
; `float` = scale the emoji picker based on this number (for example 1.25)
; `` = use QT_SCALE_FACTOR
; (requires IMF restart)
; ALERT: doesn't work currently
scaleFactor=
; `true` = Only skin tone neutral emojis are visible (hands for example)
skinTonesDisabled=false
; `not empty` = Use this (for example: Noto Color Emoji) instead of your system font to display emojis
; (requires useSystemEmojiFont=true)
systemEmojiFontOverride=
; `true` = Use your system emoji font instead of the bundled Twemoji images to display emojis
; (requires IMF restart)
useSystemEmojiFont=false
; `true` = Automatically try to scale or hide emojis based on their system emoji font support
; (May lead to false positives)
useSystemEmojiFontWidthHeuristics=true
; `true` = Use the system Qt theme instead of the builtin dark fusion theme
; (requires IMF restart)
useSystemQtTheme=false
; `0` = Invisible emoji picker window
; (requires IMF restart)
windowOpacity=0.9
; Use something like the following to add custom hotkeys (target = the default key press as seen below):
; [customHotKeys]
; 1\sourceKeyChr=#
; 1\targetKeySeq=shift+tab
; size=1
[customHotKeys]
size=0
; The files to load emoji aliases from.
; Refer to src/res/aliases/github-emojis.ini for an example
; (requires IMF restart)
[emojiAliasFiles]
1\path=:/res/aliases/github-emojis.ini
size=1-
On Debian with Gnome i had to reboot after installing to be able to configure the emoji picker input method
-
When using Wayland it seems like most window managers (Sway, KDE/KWin) force focus on new windows which conflicts with the way im-emoji-picker handles inputs. This results in the emoji picker either flickering or disappearing instantly. A workaround is to manually configure a window rule.
- Sway:
no_focus [title="im-emoji-picker"] - KDE/KWin: #13 (comment)
- Sway:
-
When using Wayland both Fcitx5 and IBus might not report the correct text cursor location so the emoji picker can open either in the top left corner or in the center of the screen
-
If the emoji picker is ugly and doesn't follow your system theme (a bit like this) then take a look at https://wiki.archlinux.org/title/Uniform_look_for_Qt_and_GTK_applications.
-
Required font localizations for Kaomoji support:
- cjk (tc, sc, kr, jp)
- kannada
- thai
- tibetan
- sinhala
ctrl+a= select all text in search inputctrl+c= copy selected emojictrl+x= cut selection in search (not really tbh)ctrl+backspace= clear searchup,down,left,right= change selectionshift+up,shift+down,pgup,pgdown= change selection (faster)escape= close emoji pickerreturn= write emoji to target inputshift+return= write emoji to target input and close emoji pickertab= change view (MRU, List, Kaomoji)shift+tab= change view (MRU, List, Kaomoji) (reverse)f4= open settings file and close emoji picker
- cmake
- make or ninja
- gcc or clang
- Qt5 (core, gui, widgets)
- fcitx5 or ibus
Arch:
sudo pacman -S gcc make cmake qt5-base fcitx5 fcitx5-qt fcitx5-gtk
Debian:
sudo apt install gcc make cmake qtbase5-dev fcitx5 fcitx5-frontend-gtk3 fcitx5-frontend-qt5 im-config
openSUSE:
sudo zypper install gcc make cmake libqt5-qtbase-devel ibus-devel
mkdir -p buildcd buildcmake -DCMAKE_BUILD_TYPE=Release ..make -j$(nproc)
- boring_nick for testing this on his arch+sway setup during the initial development phase
- zneix and other contributors for their help on the original x11-emoji-picker
Project licensed under the MIT license: LICENSE
Emoji graphics licensed by Twitter under CC-BY 4.0 at https://github.com/twitter/twemoji
Emoji list licensed by Unicode at https://github.com/unicode-org/cldr
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
