Weng Xuetian: Created page with "This page is about certain things that you can do with the dbus interface of Fcitx 5. This page will use qdbus as an command example for its simplicity. You may also use dbus..."

2023-07-28T00:20:07Z

Created page with "This page is about certain things that you can do with the dbus interface of Fcitx 5. This page will use qdbus as an command example for its simplicity. You may also use dbus..."

New page

This page is about certain things that you can do with the dbus interface of Fcitx 5.

This page will use qdbus as an command example for its simplicity. You may also use dbus-send, or busctl, but the command will be slighty different. Certain functionality is also provided by fcitx5-remote. In that case fcitx5-remote command will also be listed.

<pre>
qdbus [service name] [object path] [interface].[member] [arguments]
busctl --user call [service name] [object path] [interface] [member] [arguments]
dbus-send --session --print-reply --dest=[service name] [object path] [interface].[member] [arguments]
</pre>

For example:

Call org.fcitx.Fcitx.Controller1.ReloadConfig with argument "pinyin" with these 3 commands would be:

<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.ReloadAddonConfig pinyin
busctl --user call org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1 ReloadAddonConfig s pinyin
dbus-send --session --print-reply --dest=org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.ReloadAddonConfig string:pinyin
</pre>

= Get current input method name =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.CurrentInputMethod
fcitx5-remote -n
</pre>

= Get current input method group name =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.CurrentInputMethodGroup
fcitx5-remote -q
</pre>

= Toggle active/inactive state =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.Toggle
fcitx5-remote -t
</pre>

= Set state to active =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.Activate
fcitx5-remote -o
</pre>

= Set state to inactive =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.Deactivate
fcitx5-remote -c
</pre>

= Get current state =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.State
fcitx5-remote
</pre>

= Ask fcitx to quit =
<pre>
# Simply "killall fcitx5" is also fine.
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.Exit
fcitx5-remote -e
</pre>

= Reload configuration from disk =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.ReloadAddonConfig [addon name]
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.ReloadConfig # reload global config
</pre>

= Open a new X11 connection from Fcitx =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.OpenX11Connection [x11 display]
</pre>

= Open a new wayland connection from Fcitx =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.OpenWaylandConnection [wayland display]
</pre>

= Set current input method =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.SetCurrentIM [input method name]
fcitx5-remote -s [input method name]
</pre>

= See all the connected client to fcitx =
<pre>
# Same information is available in fcitx5-diagnose
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.DebugInfo
</pre>

= Set current group =
<pre>
qdbus org.fcitx.Fcitx5 /controller org.fcitx.Fcitx.Controller1.SwitchInputMethodGroup [group name]
fcitx5-remote -g [group name]
</pre>

DBus Interface - Revision history

Weng Xuetian: Created page with "This page is about certain things that you can do with the dbus interface of Fcitx 5. This page will use qdbus as an command example for its simplicity. You may also use dbus..."