Plover-uinput: Difference between revisions

From Plover Wiki
Line 33: Line 33:
== Troubleshooting ==
== Troubleshooting ==


=== Verify <code>ibus</code> is working ===
=== Verify ibus is working ===


# On a regular keyboard, press <code>Ctrl+Shift+U</code>.
# On a regular keyboard, press <code>Ctrl+Shift+U</code>.

Revision as of 00:19, 26 June 2024

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

Installation and setup

Plugin installation

The plover-uinput plugin is not in the plugins manager and has to be installed manually.

  1. Navigate to the folder containing the AppImage.
  2. Run the following command:
    ./plover-4.0.0rc2+6.g53c416f-x86_64.AppImage -s plover_plugins install plover-uinput
    • Note that the executable may be different if you're running a different version of Plover, or if you're not using the AppImage.
  3. Restart Plover.
  4. Go to Configure → Plugins and check the box next to plover-uinput.

For more detailed installation instructions, see the page on manually installing plugins.

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 ibus or fcitx5.

format=frameless
format=frameless

Distributions running GNOME already have ibus 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.