rofimoji1

Usage

Overview

Select, insert, or copy Unicode characters like emoji using rofi.

Options

-h, --help

Prints brief usage information.

--version

show program’s version number and exit

--action, -a

Possible values: type, copy, clipboard, type-numerical, unicode, copy-unicode, print, menu

Choose what to do with the selected characters: Directly type them with the "Typer", copy them to the clipboard using the "Clipboarder", or insert them indirectly using the clipboard. To use the compose key functionality, choose "type-numerical:. "unicode" will type the unicode codepoints of the chosen characters, "copy-unicode" will copy it. "print" just outputs them on stdout.
If you want to decide spontanously, use "menu".

--files FILE [FILE ...], -f FILE [FILE ...]

Read characters from this file (or these files), one entry per line. Absolute and relative paths are supported, as is globbing (--files /home/you/characters.csv ../other*.csv).

A filename without extension is enough (--files musical_symbols supplemental_arrows) for included character files and all in ${XDG_DATA_HOME}/rofimoji/data. Here, too, globbing is supported and done by default.

In the config file, several files need to be listed as files=[_FILE_, _FILE_].

--skin-tone=skin-tone, -s skin-tone

Possible values: neutral, light, medium-light, moderate, dark brown, black, ask

Decide on a skin-tone for all supported emojis. If not
set (or set to "ask"), you will be asked for each one

--max-recent MAX-RECENT

Show at most this number of recently used characters (cannot be larger than 10)

--no-frecency

Don’t show frequently used characters at the start.

--hidden-descriptions

Only list the characters, but not their description. Note that you can still search through the descriptions. Only used for rofi.

--use-icons

Show characters as icons on rofi. Not used with other selectors.

--prompt PROMPT, -r PROMPT

Set rofimoji’s prompt

--selector-args SELECTOR-ARGS

A string of arguments to give to the selector.

--selector SELECTOR

Possible values: rofi, wofi, fuzzel, bemenu, tofi, dmenu, wmenu, choose, hyprlauncher

Choose the selector application manually. Usually `rofi`, but you may want something else.

--clipboarder CLIPBOARDER

Possible values: xsel, xclip, wl-copy, pbcopy

Choose the application to access the clipboard with manually.

--typer TYPER

Possible values: xdotool, wtype, ydotool, cliclick, wl-ime-type

Choose the application to type with manually.

--keybinding-copy, --keybinding-type, --keybinding-clipboard, --keybinding-unicode, --keybinding-copy-unicode

Define different keybindings for these actions.

Keybindings

(optional) Select multiple emoji with shift+enter

enter to insert the emoji directly

alt+c to copy it to the clipboard

alt+t to type it directly

alt+p to insert using the clipboard

alt+1, alt+2 to insert the most recently used character (alt+2 for the second most recently one etc.)

alt+u to insert the Unicode codepoint

alt+i to copy the Unicode codepoint to the clipboard

Please note that wofi does not support keybindings other than enter.

Files

~/.config/rofimoji.rc

Per-user configuration file.

/etc/xdg/xdg-i3/rofimoji.rc

Global configuration file.

~/.local/share/rofimoji/recent

Stores the recently used characters

~/.local/share/rofimoji/data/filename.additional.csv

Contains additional characters or additional descriptions for the character set in filename

Configuration

Args that start with “--” (eg. --version) can also be set in a config file.

Config file syntax allows: key=value, flag=true, stuff=[a,b,c] (for details, see syntax at https://github.com/fdw/rofimoji#example-config-file). If an arg is specified in more than one place, then commandline values override values from the config file.

Website

https://github.com/fdw/rofimoji