IBUS(1)

💖 IBUS(1) 💖

bestie. sit down. grab a strawberry 🍓. this is the User Commands manual page for ibus — section 1, the classic — and honestly? it's a whole vibe. ✨

---

✨ NAME ✨

ibus — command line utility for ibus 💅

---

🎀 SYNOPSIS 🎀

ibus COMMAND [OPTION]...

---

🦋 DESCRIPTION 🦋

IBus is an Intelligent Input Bus. no literally, that's its name, it's giving very main character. it's a new input framework for Linux OS, and it serves up a full featured, user friendly input method user interface. it also helps developers build input methods easily — so thoughtful of it 🫶.

ibus itself is the command line utility. with it you can restart or exit ibus-daemon, get or set the current ibus engine, or list the ibus engines. that's the whole toolkit, no cap.

Homepage: https://github.com/ibus/ibus/wiki

---

🌈 COMMAND 🌈

every single one, in order, no skips, no summarising, we don't do that here 💖

• help — shows the commands list. that's it. that's the girl.
• engine [ENGINE_NAME] — if you don't hand it an ENGINE_NAME, it shows you the current ibus engine. give it an ENGINE_NAME and it sets that to be the current ibus engine. one command, two moods.
• exit — exits ibus-daemon. bye bestie 👋💀
• list-engine — shows the ibus engines list. iconic.
• restart [--type=TYPE|--verbose|--help] — restarts ibus-daemon.
  • by default it tries to restart ibus-daemon via systemd firstly and directly secondary. so: systemd first, direct as the backup plan.
  • --type=systemd — tries to restart via systemd only.
  • --type=direct — tries to restart with an IBus API only.
  • --verbose — it's in the usage line; the source doesn't spell out more, so I'm not gonna invent it, iykyk 🙈.
  • --help — same deal, bestie.
  • 🧚 little lore drop: GNOME desktop runs ibus-daemon via systemd, and other desktops run ibus-daemon directly.
• start [--type=TYPE|--verbose|--help] — starts ibus-daemon.
  • by default it tries to start ibus-daemon via systemd firstly and directly secondary.
  • --type=systemd — tries to start as a background process via systemd only.
  • --type=direct — tries to start directly only, as a foreground process — and heads up, the other option arguments of the ibus command get sent to ibus-daemon. like, for real:

ibus start --type=direct --xim &

• --verbose — in the usage line, source says nothing extra, so neither do I 💅.
• --help — same.
• 🧚 and again: GNOME desktop runs ibus-daemon via systemd, other desktops run ibus-daemon directly.

• version — shows the ibus version.
• read-cache [--system|--file=FILE|--help] — shows the content of a registry cache:
  • no --system → it shows the content of the user registry cache.
  • --system — shows the content of the system registry cache.
  • --file=FILE — shows the content of the custom registry cache FILE.
  • --help — in the usage line, that's all the source gives us.
• write-cache [--system|--file=FILE|--help] — saves a registry cache:
  • no --system → saves the user registry cache.
  • --system — saves the system registry cache.
  • --file=FILE — saves the custom registry cache FILE.
  • --help — same energy, it's just in the usage line.
  • 📌 and here's the tea: by default it reads the component XML files from the standard component directory /usr/share/ibus/component. you can set the IBUS_COMPONENT_PATH environment variable for custom component directories, separated by ':'.
• address — shows the D-Bus address of ibus-daemon.
• read-config — prints the setting values in a gsettings configuration file.
• reset-config — resets the user setting values to the default ones in a gsettings configuration file. factory reset but make it cute.
• watch — Under construction. 🚧 we love a mystery.
• emoji [--font=FONT|--lang=LANG|--help|--partial-match] — launches IBus Emojier ( ibus-emoji (1) ) and saves the emoji you pick straight to your clipboard. obsessed. 😭💖
  • --font=FONT — choose an emoji font.
  • --lang=LANG — choose the language of the emoji annotations. if LANG="en", IBus Emojier loads /usr/share/ibus/dicts/emoji-en.dict.
  • --partial-match — enables matching annotations with a partial string.
  • --help — it's in the usage line, bestie.
  • ✨ these settings are also available with the ibus-setup (1) utility.
• im-module [--type=TYPE|--help] — shows an internal im-module value inside a virtual GTK application. if IBus is installed and configured properly, the output is "ibus". this one is for the girlies who build IBus from the source codes and want to check the configurations 🫶.
  • currently this sub-command supports GTK applications only, and the default is GTK3.
  • --type=gtk4 — if you wish to check a GTK4 application, specify this. and you can choose one of "gtk2", "gtk3" and "gtk4".
  • --help — in the usage line, as ever.

---

💀 BUGS 💀

if you find a bug, please report it at https://github.com/ibus/ibus/issues. be nice about it, they're doing their best 🫶

---

👑 SEE ALSO 👑

ibus-emoji(7)

---

okay that's the whole page, you ate that 💅✨ this was ibus 1.5.34, dated Jul 2022 — go forth and input-method, bestie 🌸🦋🎀