.\" Automatically generated by Pandoc 3.7.0.2
.\"
.TH "ROFIMOJI" "1" "September 09, 2025" "Version 6.7.0" "Rofi Third\-party Add\-on Documentation"
.SH NAME
\f[B]rofimoji\f[R] \- An emoji and general character picker for rofi and
rofi\-likes
.SH SYNOPSIS
.PP
\f[B]rofimoji\f[R] [\f[B]\-h\f[R]] [\f[B]\-\-version\f[R]]
[\f[B]\-\-action\f[R]
{\f[I]type\f[R],\f[I]copy\f[R],\f[I]clipboard\f[R],\f[I]type\-numerical\f[R],\f[I]unicode\f[R],\f[I]copy\-unicode\f[R],\f[I]print\f[R],\f[I]menu\f[R]}]
[\f[B]\-\-skin\-tone\f[R]
{\f[I]neutral\f[R],\f[I]light\f[R],\f[I]medium\-light\f[R],\f[I]moderate\f[R],\f[I]dark
brown\f[R],\f[I]black\f[R],\f[I]ask\f[R]}] [\f[B]\-\-files\f[R]
{\f[I]all\f[R],\f[I]FILE\f[R] [\f[I]FILE\f[R] \&...]]}
[\f[B]\-\-prompt\f[R] \f[I]PROMPT\f[R]] [\f[B]\-\-selector\-args\f[R]
\f[I]SELECTOR_ARGS\f[R]] [\f[B]\-\-max\-recent\f[R]
\f[I]MAX_RECENT\f[R]] [\f[B]\-\-no\-frecency\f[R]]
[\f[B]\-\-hidden\-descriptions\f[R]] [\f[B]\-\-clipboarder\f[R]
\f[I]CLIPBOARDER\f[R]] [\f[B]\-\-typer\f[R] \f[I]TYPER\f[R]]
[\f[B]\-\-selector\f[R] \f[I]SELECTOR\f[R]]
.SH DESCRIPTION
Select, insert, or copy Unicode characters like emoji using rofi.
.SH OPTIONS
.TP
\-h, \-\-help
Prints brief usage information.
.TP
\-\-version
show program\(cqs version number and exit
.TP
\-\-action, \-a
Possible values: type, copy, clipboard, type\-numerical, unicode,
copy\-unicode, print, menu
.RS
.PP
Choose what to do with the selected characters: Directly type them with
the \(lqTyper\(rq, copy them to the clipboard using the
\(lqClipboarder\(rq, or insert them indirectly using the clipboard.
To use the compose key functionality, choose
\(lqtype\-numerical:.\(rqunicode\(rq will type the unicode codepoints of
the chosen characters, \(lqcopy\-unicode\(rq will copy it.
\(lqprint\(rq just outputs them on stdout.
If you want to decide spontanously, use \(lqmenu\(rq.
.RE
.TP
\-\-files \f[I]FILE\f[R] [\f[I]FILE\f[R] \&...], \-f \f[I]FILE\f[R] [\f[I]FILE\f[R] \&...]
Read characters from this file (or these files), one entry per line.
Absolute and relative paths are supported, as is globbing
(\f[CR]\-\-files /home/you/characters.csv ../other*.csv\f[R]).
A filename without extension is enough
(\f[CR]\-\-files musical_symbols supplemental_arrows\f[R]) for included
character files and all in \f[CR]${XDG_DATA_HOME}/rofimoji/data\f[R].
Here, too, globbing is supported and done by default.
In the config file, several files need to be listed as
\f[CR]files=[_FILE_, _FILE_]\f[R].
.TP
\-\-skin\-tone=\f[I]skin\-tone\f[R], \-s \f[I]skin\-tone\f[R]
Possible values: neutral, light, medium\-light, moderate, dark brown,
black, ask
.RS
.PP
Decide on a skin\-tone for all supported emojis.
If not set (or set to \(lqask\(rq), you will be asked for each one
.RE
.TP
\-\-max\-recent \f[I]MAX\-RECENT\f[R]
Show at most this number of recently used characters (cannot be larger
than 10)
.TP
\-\-no\-frecency
Don\(cqt show frequently used characters at the start.
.TP
\-\-hidden\-descriptions
Only list the characters, but not their description.
Note that you can still search through the descriptions.
Only used for \f[CR]rofi\f[R].
.TP
\-\-use\-icons
Show characters as icons on \f[CR]rofi\f[R].
Not used with other selectors.
.TP
\-\-prompt \f[I]PROMPT\f[R], \-r \f[I]PROMPT\f[R]
Set rofimoji\(cqs prompt
.TP
\-\-selector\-args \f[I]SELECTOR\-ARGS\f[R]
A string of arguments to give to the selector.
.TP
\-\-selector \f[I]SELECTOR\f[R]
Possible values: rofi, wofi, fuzzel, bemenu, tofi, dmenu, wmenu, choose
.RS
.PP
Choose the selector application manually.
Usually \f[CR]rofi\f[R], but you may want something else.
.RE
.TP
\-\-clipboarder \f[I]CLIPBOARDER\f[R]
Possible values: xsel, xclip, wl\-copy, pbcopy
.RS
.PP
Choose the application to access the clipboard with manually.
.RE
.TP
\-\-typer \f[I]TYPER\f[R]
Possible values: xdotool, wtype, ydotool, cliclick
.RS
.PP
Choose the application to type with manually.
.RE
.TP
\-\-keybinding\-copy, \-\-keybinding\-type, \-\-keybinding\-clipboard, \-\-keybinding\-unicode, \-\-keybinding\-copy\-unicode
Define different keybindings for these actions.
.SH KEYBINDINGS
(optional) Select multiple emoji with shift+enter
.PP
\f[I]enter\f[R] to insert the emoji directly
.PP
\f[I]alt+c\f[R] to copy it to the clipboard
.PP
\f[I]alt+t\f[R] to type it directly
.PP
\f[I]alt+p\f[R] to insert using the clipboard
.PP
\f[I]alt+1\f[R], \f[I]alt+2\f[R] to insert the most recently used
character (alt+2 for the second most recently one etc.)
.PP
\f[I]alt+u\f[R] to insert the Unicode codepoint
.PP
\f[I]alt+i\f[R] to copy the Unicode codepoint to the clipboard
.PP
Please note that wofi does not support keybindings other than
\f[I]enter\f[R].
.SH FILES
.TP
\f[I]\(ti/.config/rofimoji.rc\f[R]
Per\-user configuration file.
.TP
\f[I]/etc/xdg/xdg\-i3/rofimoji.rc\f[R]
Global configuration file.
.TP
\f[I]\(ti/.local/share/rofimoji/recent\f[R]
Stores the recently used characters
.TP
\f[I]\(ti/.local/share/rofimoji/data/\f[BI]filename\f[I].additional.csv\f[R]
Contains additional characters or additional descriptions for the
character set in \f[B]filename\f[R]
.SH CONFIGURATION
Args that start with \(lq\-\-\(rq (eg.
\-\-version) can also be set in a config file.
.PP
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.
.SH WEBSITE
https://github.com/fdw/rofimoji
.SH AUTHORS
Fabian Winter.