$ mkdir build && cd build && cmake -DCMAKE_BUILD_TYPE=release .. && make -j$(nproc)

$ sudo make install

$ yay -Sy jome-git

There are 4️⃣ sections:

🔍 box (⬆️)

Input box where you can ⌨️ a query to 🔍 emojis.

Emojis

All emojis (with an empty 🔍 box) or 🔍 results.

When there’s at least 1️⃣ emoji, there’s always a selected emoji with a 🔴 box around it.

🖱 an emoji to accept it.

Hover an emoji to update the ⬇️ emoji info text temporarily.

Use the -d option to make the background behind emojis dark.

Category list

List of available categories.

When all emojis are 👁 (the 🔍 box is empty), 🖱 a category name to scroll to this emoji category.

The first category, Recent, is a special category with the recently accepted emojis.

Emoji info text (⬇️)

Name, Unicode codepoints, and Emoji version of the selected or hovered emoji.

The power of jome is its 🔍 box.

When you launch jome, the 🔍 box is focused, and it should stay focused unless you browse emojis manually with the intention of accepting one with the 🖱.

The format of a query is 1️⃣ of:

• TERMS

• CAT/

• CAT/TERMS

where:

CAT

Partial name of categories in which to 🔍.

TERMS

Space-separated list of 🔍 terms.

For an emoji to be part of the results, at least 1️⃣ of its keywords must contain all the 🔍 terms.

To select an emoji, use the following ⌨️:

⬅️, ➡️, ⬆️, ⬇️

Go ⬅️/➡️/⬆️/⬇️.

Ctrl+⬅️, Ctrl+➡️

Go ⬅️/➡️ 5️⃣ emojis.

Page ⬆️, Page ⬇️

Go ⬆️/⬇️ 10 rows.

Home

Go to the first emoji.

End

Go to the last emoji.

To accept the selected emoji, 👇:

Enter

Accept the selected emoji with the default skin tone (if applicable).

F1, F2, F3, F4, F5

If the selected emoji supports skin tones, accept the selected emoji with a light, medium-light, medium, medium-dark, or dark skin tone.

To cancel, 👇 Escape or close the 🪟.

To go to the Emojipedia 📃 of the selected emoji, 👇 F12.

To go to the Emojipedia 📃 of any emoji with the 🖱, right-click it and click “Go to Emojipedia page”.

-f FMT

Set the output format to FMT:

utf-8 (default)

UTF-8 emoji.

cp

Space-separated Unicode codepoints (hexadecimal).

Example: 1f645 200d 2642 fe0f

-p PREFIX

Set the prefix to be prepended to each Unicode codepoint.

For example, with -f cp and -p U+: U+1f645 U+200d U+2642 U+fe0f.

-n

Do not 🖨 a newline after 🖨 the emoji or codepoints.

-c CMD

When you accept an emoji, execute command CMD 20 ms after closing the jome 🪟.

jome interprets CMD like a 🐚 does, so you can have arguments too.

CMD receives the UTF-8 emoji or the Unicode codepoints (depending on the -f option) with their optional prefix as its last argument(s).

Examples with xdotool:

$ jome -c 'xdotool type'
$ jome -f cp -p U -c 'xdotool key --delay 20'

-b

When you accept an emoji, copy the UTF-8 emoji or the Unicode codepoints (depending on the -f option) to the 📋.

-q

Do not quit when you accept an emoji.

By default, when you accept an emoji (with the ⌨️ or with the 🖱), jome:

1. 🖨 the accepted emoji or its codepoints to the standard output.

2. Hides its 🪟.

3. Optional: Copies the accepted emoji/codepoints to the clipboard (see the -b option).

4. Optional: Executes a command (see the -c option) after 20 ms.

5. If not running in server mode, quits (see the -s option).

With the -q option, jome does not hide its 🪟 and does not quit when you accept an emoji so that you can make it 🖨 multiple emojis and/or execute a command multiple ⏲ with multiple emojis without restarting the application.

You cannot specify the -q and -s options at the same ⏲.

-s NAME

Start jome in server mode and set the server name to NAME.

On Unix, this creates the socket 📄 /tmp/NAME which must not exist before you start jome.

You cannot specify the -s and -q options at the same ⏲.

-d

Use a dark background for emojis.

-w WIDTH

Set the width of individual emojis to WIDTH pixels, amongst 16, 24, 32 (default), 40, or 48.

jome features a server mode to avoid creating a process (a Qt 🪟 can be quite long to create) every ⏲ you need to pick an emoji. With this mode, you can 👁 the jome 🪟 instantaneously.

To start jome in server mode, use the -s option to specify the server name:

This creates a local server named mein-server. On Unix, it creates the socket 📄 /tmp/mein-server.

When jome starts in server mode, it does not 👁 its 🪟. Instead, it ⌛ for a command sent by the client, jome-ctl. To 👁 the 🪟:

When you accept an emoji, jome-ctl 🖨 what jome also 🖨 to the standard output and quits with exit code 0️⃣. Therefore, the output format of jome-ctl is 🎛 by the options passed to jome.

If you cancel jome (press Escape or close the 🪟), jome-ctl 🖨 nothing and returns with exit code 1️⃣.

In server mode, jome does not quit once you accept an emoji or cancel: it hides the 🪟 and keeps 👂. To make it quit gracefully, which also removes the socket 📄:

You don’t need to use what jome-ctl 🖨 to the standard output. You can use jome in server mode with the -c option to make jome execute a command itself. For example:

Then, bind a ⌨️ shortcut to:

With xdotool key

#!/usr/bin/bash

codepoints="$(jome -f cp -p U)"

if [ $? -ne 0 ]; then
    exit 1
fi

xdotool key --delay 20 $codepoints

With xdotool type

#!/usr/bin/bash

emoji="$(jome)"

if [ $? -ne 0 ]; then
    exit 1
fi

xdotool type "$emoji"

With xdotool key

#!/usr/bin/bash

socket_name="jome.socket.$(id -u)"

if ! pidof jome &>/dev/null; then
    rm -f "/tmp/$socket_name"
    jome -s "$socket_name" -f cp -p U -c 'xdotool key --delay 20' & disown

    while [ ! -e "/tmp/$socket_name" ]; do
        sleep .1
    done
fi

jome-ctl "$socket_name"

With xdotool type

#!/usr/bin/bash

socket_name="jome.socket.$(id -u)"

if ! pidof jome &>/dev/null; then
    rm -f "/tmp/$socket_name"
    jome -s "$socket_name" -c 'xdotool type' & disown

    while [ ! -e "/tmp/$socket_name" ]; do
        sleep .1
    done
fi

jome-ctl "$socket_name"