Skip to content

esrille/oskim

Repository files navigation

On-Screen Keyboard improved for Input Methods

On-Screen Keyboard improved for Input Methods (OSKIM) is a GNOME Shell extension. It extends GNOME On-Screen Keyboard (OSK). OSKIM contains a mechanism to provide dedicated on-screen keyboard layers for each Input Method Engine (IME). Currently, OSKIM supports Japanese Hiragana IME for IBus.

OSKIM has been tested with GNOME 42.5 on Ubuntu 22.04 LTS. We will support newer versions of GNOME Shell in the future.

Installation

1a. Install the OSKIM bundle downloaded from Releases

Download the OSKIM bundle from Releases and install it by running the following command:

$ gnome-extensions install oskim@esrille.com-0.0.0.shell-extension.zip

1b. Install from this repository

Alternatively, you can clone the OSKIM repository under the GNOME shell extensions directory as below:

$ git clone https://github.com/esrille/oskim.git ~/.local/share/gnome-shell/extensions/oskim@esrille.com

2. Enable OSKIM

Enable OSKIM by running the following command:

$ gnome-extensions enable oskim@esrille.com

If you prefer GUI tools, you could use Extension Manager.

On-Screen Keyboard Layers for Hiragana IME

OSKIM supports Hiragana IME for IBus v0.15.0 or later.

OSKIM provides multiple on-screen keyboard layers for Hiragana IME. The active on-screen keyboard layer is synchronized with the current input mode of the Hiragana IME.

Alphanumeric mode (A)

normal shift ?123

Hiragana mode (あ) for Kana typing

normal shift ?123

Hiragana mode (あ) for Rōmaji typing

normal shift ?123