Plover-uinput

From Plover Wiki
Revision as of 14:20, 29 August 2024 by Thai (talk | contribs) (Update plugin installation now that plugin is in plugins manager. Add note about keyboard not being supported based on maintainer conversation in discord.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Background

Plover is not officially supported on Wayland. There are several workarounds to deal with this. The plover-uinput plugin should (in theory) work across all systems running Wayland. It has been confirmed to work on the following setups:

  • Debian 12 GNOME 43
  • Fedora 40 GNOME 46

Note that the plugin does not support using a machine type of keyboard.

Installation and setup

Plugin installation

  1. Open the plugins manager.
  2. Find plover-uinput in the list.
  3. Press Install/Update
  4. Proceed with the installation.
  5. Press Restart after it is finished.

For more detailed steps for installation, see the plugins page

Post-installation setup

Add your user to the input group with the following command:

sudo usermod -aG input $USER

Create a file at /etc/udev/rules.d/90-plover-uinput.rules with the following content:

KERNEL=="uinput", GROUP="input", MODE="0660", OPTIONS+="static_node=uinput"

For full Unicode support (emoji, accented letters, etc), install the ibus or fcitx5 package.

format=frameless
format=frameless

Distributions running GNOME already have the ibus package installed.

After setup has been complete, restart your computer to ensure the changes take effect.

Troubleshooting

Verify ibus is working

  1. On a regular keyboard, press Ctrl+Shift+U.
  2. You should see an underlined u appear.
  3. Type 1f990 and press enter.
  4. You should see 🦐 appear.