ROFIMOJI(1)

📦
version 6.8.0 · 4 versions
, in arch rolling

💖 NAME 💖

okay so first things first: this is rofimoji(1), part of the Rofi Third-party Add-on Documentation fam, and it’s literally an emoji and general character picker for rofi and rofi-likes. Main character energy, no cap. 🫶

✨ SYNOPSIS ✨

rofimoji [-h] [--version] [--action
{type,copy,clipboard,type-numerical,unicode,copy-unicode,print,menu}]
[--skin-tone {neutral,light,medium-light,moderate,dark brown,black,ask}]
[--files {all,FILE [FILE ...]]} [--prompt PROMPT] [--selector-args
SELECTOR_ARGS] [--max-recent MAX_RECENT] [--no-frecency]
[--hidden-descriptions] [--clipboarder CLIPBOARDER] [--typer TYPER]
[--selector SELECTOR]

🌸 DESCRIPTION 🌸

Select, insert, or copy Unicode characters — emoji absolutely included, bestie — using rofi. That’s the whole vibe. 🦋

💅 OPTIONS 💅

  • -h, --help — prints brief usage information. It’s giving “help me help you” in the best way. 🫶
  • --version — show program’s version number and exit. Slay, bye. 👑
  • --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 spontaneously, 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 the 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). The receipts have a limit, bestie. 🧾
  • --no-frecency — don’t show frequently used characters at the start. Sometimes you want a fresh feed, yk? 🌱
  • --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. Cute little icon moment. 🎀
  • --prompt PROMPT, -r PROMPT — set rofimoji’s prompt. Make it say something iconic. 💬
  • --selector-args SELECTOR-ARGS — a string of arguments to give to the selector. Extra selector lore. 🧚
  • --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. Customize your little keyboard era. 💫

🎀 KEYBINDINGS 🎀

  • (optional) Select multiple emoji with shift+enter. Multi-select slay. ✨
  • enter to insert the emoji directly. The classic. 💖
  • alt+c to copy it to the clipboard. Clipboard bestie behavior. 📋
  • alt+t to type it directly. Typing era. ⌨️
  • alt+p to insert using the clipboard. Sneaky little paste vibe. 🫶
  • alt+1, alt+2 to insert the most recently used character (alt+2 for the second most recently one etc.). Recent-core. 🕰️
  • alt+u to insert the Unicode codepoint. Nerdy and iconic. 🧚
  • alt+i to copy the Unicode codepoint to the clipboard. Copy the lore. 📝
🚨 bestie warning: wofi does not support keybindings other than enter. Not me finding out the hard way. 💀

🗂️ FILES 🗂️

  • ~/.config/rofimoji.rc — per-user configuration file. It’s giving personalization. 💅
  • /etc/xdg/xdg-i3/rofimoji.rc — global configuration file. Big system energy. 🌍
  • ~/.local/share/rofimoji/recent — stores the recently used characters. The receipts, basically. 🧾
  • ~/.local/share/rofimoji/data/filename.additional.csv — contains additional characters or additional descriptions for the character set in filename. Extra character lore drop. 🦋

⚙️ CONFIGURATION ⚙️

Args that start with -- (eg. --version) can also be set in a config file. Very “set it and forget it” of them. ✨

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. Command line stays winning, fr fr. 👑

🌐 WEBSITE 🌐

https://github.com/fdw/rofimoji

👑 AUTHORS 👑

Fabian Winter. Author icon behavior. 🫶

mwah 💋 — that’s the manual, bestie. Source fam: Rofi Third-party Add-on Documentation; version 6.8.0; date June 20, 2026; manual ROFIMOJI(1). periodt. 🫶

📦 where this page comes from