ibus provides “ibus” CLI utility.
Shows the current ibus engine. If a engine name is appended to this command, ibus switches to the engine. E.g.
ibus engine anthy
Show registered engine names.
Show ibus version number.
Exit ibus-daemon. You might start ibus with
ibus-daemon --xim --verbose
Show this information.
When ibus-daemon runs initially, ibus converts component files in /usr/share/ibus/component to a cache file and loads the cache file instead of the component files for the performance. The cache file is the system cache of /var/cache/ibus/bus/registry or the user cache of $HOME/.cache/ibus/bus/registry .
ibus read-cache shows the user cache.
ibus read-cache --system shows the system cache. You can notice more sub-commands with
ibus read-cache --help
Write the user cache of $HOME/.cache/ibus/bus/registry . The user cache file is automatically generated if the system cache does not exist when ibus-daemon runs. You can generate the system cache of /var/cache/ibus/bus/registry with
ibus write-cache --system with the root permission. Generally the system cache is generated with the package scripts during installations of ibus and ibus engine packages. You can notice more sub-commands with
ibus write-cache --help
Show the configuration values.
Reset the configuration values. This command resets the setting of the ibus core only but not ones of ibus engines. This command is useful to clean up the user configuration when you have a trouble. E.g. upgrade installation. You also can use gsettings command directly to set each value.
You may notice ibus-setup GUI cannot assign Shift+Ctrl to switch engines because both Shift and Ctrl is modifiers key. If you wish, you can assign it with gsettings command directly:
% gsettings get org.freedesktop.ibus.general.hotkey triggers ['<Super>space'] % gsettings set org.freedesktop.ibus.general.hotkey triggers ['<Shift>Control_L']
ibus shows the language prefix of the ibus XKB engine on ibus panel icon. The default color is a blue. You can customize the color with gsettings command.
% gsettings get org.freedesktop.ibus.panel xkb-icon-rgba '#415099'
The value format of xkb-icon-rgba is described in https://github.com/ibus/ibus/blob/master/data/ibus.schemas.in
ibus displays the engine switcher dialog with Super+space key. The default delay time is 400 milliseconds. If you switch two engines only and the dialog is not needed, you can set the value of switcher-delay-time to -1.
% gsettings get org.freedesktop.ibus.general switcher-delay-time 400
If your preferred XKB engine is not show on ibus-setup, you can add that engine in /usr/share/ibus/component/simple.xml by manual.
<engine> <name>xkb:us:mac:eng</name> <language>eng</language> <license>GPL>/license> <author>Peng Huang <email@example.com></author> <layout>us</layout> <layout_variant>mac</layout_variant> <longname>English (Macintosh)</longname> <description>English (Macintosh)</description> <icon>ibus-keyboard</icon> <rank>99</rank> </engine>