When there’s at least one emoji, there’s always a selected emoji with a square box around it.

Click an emoji to accept it. Press Shift when clicking to not print VS-16 codepoints (see the -V option).

Hover an emoji to update the bottom emoji info text temporarily.

Make the background behind emojis dark with the -d option.

Hide the category labels with the -L option.

Hide the “Recent” category with the -R option.

When all emojis are viewed (the find box is empty), click a category name to scroll to this emoji category.

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

Override the maximum number of recently accepted emojis with the -H option.

Hide the “Recent” category with the -R option.

Hide the whole category list with the -C option.

Hide the keyword list with the -k option.

For an emoji to be part of the results, its name and keywords must contain ALL the searched terms.

Without the -t option

With the -t option

See the -V option option.

See the -V option option.

{


  "🍁": {


    "extra-keywords": ["canada", "laurentides"]


  },


  "😃": {


    "keywords": ["yay", "hourra"]


  },


  "🚬": {


    "extra-keywords": ["claude poirier"]


  },


  "🫚": {


    "extra-keywords": ["canada dry", "martin deschamps"]


  }
}

$ jome -s mein-server

On Unix, the server mode won’t work if the socket file
already exists. Remove the file before you start jome in server mode:

$ rm -f /tmp/mein-server
$ jome -s mein-server

$ jome-ctl mein-server

$ jome-ctl mein-server quit

$ rm -f /tmp/mein-server
$ jome -s mein-server -c 'xdotool type'

$ jome-ctl mein-server

With xdotool key

#!/usr/bin/bash
codepoints=$(jome -f cp -p U)
if (($? != 0)); then


    exit 1
fi
xdotool key --delay 20 "$codepoints"

With xdotool type

#!/usr/bin/bash
emoji=$(jome)
if (($? != 0)); then


    exit 1
fi
xdotool type "$emoji"

With xdotool key

#!/usr/bin/bash
socket_name=jome.socket.$(id -u)
if [[ ! -e "/tmp/$socket_name" ]]; then


    jome -s "$socket_name" -n -w48 -f cp -p U & disown


    until [[ -e "/tmp/$socket_name" ]]; do


        sleep .1


    done
fi
codepoints=$(jome-ctl "$socket_name")
if (($? == 0)); then


    sleep .02


    xdotool key --delay 20 "$codepoints"
fi

With xdotool type

#!/usr/bin/bash
socket_name=jome.socket.$(id -u)
if [[ ! -e "/tmp/$socket_name" ]]; then


    jome -s "$socket_name" -n -w48 & disown


    until [[ -e "/tmp/$socket_name" ]]; do


        sleep .1


    done
fi
emoji=$(jome-ctl "$socket_name")
if (($? == 0)); then


    sleep .02


    xdotool type "$emoji"
fi

utf-8 (default)

cp

For example, with -f cp and -p U+:

U+1f645 U+200d U+2642 U+fe0f

VS-16 is a suffix codepoint which specifies that the preceding character should be displayed with emoji presentation. For example, ♥ (which predates Unicode emojis) followed with VS-16 becomes a red heart.

There are applications/fonts which don’t like VS-16.

L

ML

M

MD

D

The F1 to F5 keys still acept an emoji with a specific skin tone.

jome interprets CMD like a shell 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'

By default, when you accept an emoji (with the keyboard or with the mouse), jome:

With the -q option, jome doesn’t hide its window and doesn’t quit when you accept an emoji so that you can make it print multiple emojis and/or execute a command multiple time with multiple emojis without restarting the application.

You cannot specify the -q and -s options together.

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

You cannot specify the -s and -q options together.

In this case, jome shows the recently accepted emojis first within the result grid.

The selection box doesn’t flash by default.