/seogi

Hangul IME for Wayland

Primary LanguageCMIT LicenseMIT

Seogi

Hangul IME for Wayland, based on wlhangul by Simon Ser.

Building

Seogi depends on libhangul, libsystemd, libxkbcommon, and Wayland.

meson build
ninja -C build
build/seogi

Usage

The following environment variables need to be set in order for the IME to work:

export GTK_IM_MODULE=wayland
export QT_IM_MODULE=wayland
export XMODIFIERS="@im=wayland"

Additionally, your Wayland compositor must support the input-method-unstable-v2 and virtual-keyboard-unstable-v1 protocols. Currently only Sway has been tested.

After running seogi, the mode can be toggled with the Hangul key by default. The toggle key can be modified as follows:

seogi -k Alt_R

The list of keys that can be used for the toggle key can be found in xkbcommon-keysyms.h from libxkbcommon. Remove the XKB_KEY_ prefix from the key name and pass it to seogi through the -k parameter.

For a more complete list of parameters, run seogi --help.

Seogi includes a D-Bus service for observing its state (i.e., whether or not Hangul mode is enabled). It also includes methods for toggling, enabling, or disabling Seogi on a seat. See seogi-waybar for an example of this in action.

License

MIT