tofi(1)

📦
version 0.9.1 · 8 versions
, in opensuse-leap 16.0

🎀 tofi(1) — General Commands Manual 🎀

bestie, welcome to tofi(1), the manual page for the tiny dynamic menu that is genuinely iconic. It’s a Wayland menu inspired by rofi(1) and dmenu(1), and yes, it ate. 💅

✨ NAME ✨

tofi — Tiny dynamic menu for Wayland, inspired by rofi(1) and dmenu(1). No cap, that’s the whole name section and it’s serving. 🦋

🌸 SYNOPSIS 🌸

tofi [options...]

tofi-run [options...]

tofi-drun [options...]

💖 DESCRIPTION 💖

tofi is a tiny dynamic menu for Wayland compositors supporting the layer-shell protocol. It reads newline-separated items from stdin, and displays a graphical selection menu. When a selection is made, it is printed to stdout. That’s the whole flow: items in, menu up, choice out. Periodt. ✨

When invoked via the name tofi-run, tofi will not accept items on stdin, and instead presents a list of executables in the user’s $PATH. It’s giving “run stuff from anywhere” energy. 👑

When invoked via the name tofi-drun, tofi will not accept items on stdin, and will generate a list of applications from desktop files as described in the Desktop Entry Specification. Desktop-entry slay. 🖥️💅

⭐ OPTIONS ⭐

  • -h, --help — Print help and exit. Short, sweet, and helpful. 🫶
  • -c, --config <path> — Specify path to custom config file. Tell tofi where your config lives, bestie. 🎀

All config file options described in tofi(5) are also accepted, in the form --key=value. So yes, the config file lore goes deep — but the CLI can take it too. 😌

🎹 KEYS 🎹

  • <Up> | <Left> | <Ctrl>-k | <Ctrl>-p — Move the selection back one entry. 👈
  • <Down> | <Right> | <Ctrl>-j | <Ctrl>-n | <Tab> — Move the selection forward one entry. 👉
  • <Page Up> — Move the selection back one page. Back it up, back it up. 📄
  • <Page Down> — Move the selection forward one page. Keep scrolling, bestie. 📃
  • <Ctrl>-u — Delete line. Gone. Absolutely deleted. 💀
  • <Ctrl>-w | <Ctrl>-<Backspace> — Delete word. One word at a time, very demure. 🧚
  • <Enter> — Confirm the current selection and quit. Choose your main character and dip. ✅
  • <Escape> — Quit without making a selection. Exit stage left, no selection made. 🚪

📁 FILES 📁

  • /etc/xdg/tofi/config — Example configuration file. A little example to look at. 🍓
  • $XDG_CONFIG_HOME/tofi/config — The default configuration file location. This is the one tofi looks at by default. 🏠
  • $XDG_CACHE_HOME/tofi-compgen — Cached list of executables under $PATH, regenerated as necessary. Cache behavior, but make it cute. 🦋
  • $XDG_CACHE_HOME/tofi-drun — Cached list of desktop applications, regenerated as necessary. App list cache, locked and loaded. 📦
  • $XDG_STATE_HOME/tofi-history — Numeric count of commands selected in tofi-run, to enable sorting results by run count. History for your run-count sorting era. 🔥
  • $XDG_STATE_HOME/tofi-drun-history — Numeric count of commands selected in tofi-drun, to enable sorting results by run count. Same history energy, but for tofi-drun. 🌈

👑 AUTHORS 👑

Philip Jones <philj56@gmail.com> — author icon, honestly. 💜

🔗 SEE ALSO 🔗

tofi(5), dmenu(1) rofi(1)

Go read the friends and family: tofi(5), dmenu(1) rofi(1). Iykyk. ✨

This page is from the tofi(1) manual, dated 2024-08-06 — mwah, bestie, go slay your Wayland menu. 💋🎀

📦 where this page comes from