Plover-uinput: Difference between revisions

Latest revision as of 22:18, 22 May 2025

format=frameless

This page needs clean-up. The information may be complete, but help revise the page by removing first-person speech, breaking up large blocks of text, adding inter-wiki links, and making information more concise and easy-to-read.

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

Open the plugins manager.
Find plover-uinput in the list.
Press Install/Update
Proceed with the installation.
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

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

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

@@ Line 1: / Line 1: @@
+{{Cleanup}}
 == Background ==
 Plover is not officially supported on Wayland. There are several workarounds to deal with this. The <code>[https://github.com/LilleAila/plover-uinput plover-uinput]</code> plugin should (in theory) work across all systems running Wayland. It has been confirmed to work on the following setups:
@@ Line 4: / Line 6: @@
 * 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 ===
-The <code>plover-uinput</code> plugin is not in the plugins manager and has to be installed manually.
-# Navigate to the folder containing the AppImage.
+# Open the plugins manager.
-# Run the following command: <pre>./plover-4.0.0rc2+6.g53c416f-x86_64.AppImage -s plover_plugins install plover-uinput</pre>
+# Find <code>plover-uinput</code> in the list.
-#* Note that the executable may be different if you're running a different version of Plover, or if you're not using the AppImage.
+# Press <code>Install/Update</code>
-# Restart Plover.
+# Proceed with the installation.
-# Go to <code>Configure → Plugins</code> and check the box next to <code>plover-uinput</code>.
+# Press <code>Restart</code> after it is finished.
-For more detailed installation instructions, see the page on [[Plugins#Linux|manually installing plugins]].
+For more detailed steps for installation, see the [[Plugins#How to Install Plugins|plugins page]]
 === Post-installation setup ===
@@ Line 27: / Line 29: @@
 <pre>KERNEL=="uinput", GROUP="input", MODE="0660", OPTIONS+="static_node=uinput"</pre>
-For full Unicode support (emoji, accented letters, etc), install <code>ibus</code> or <code>fcitx5</code>.
+For full Unicode support (emoji, accented letters, etc), install the <code>ibus</code> or <code>fcitx5</code> package.
-{{Info|text=Distributions running GNOME already have <code>ibus</code> installed.}}
+{{Info|text=Distributions running GNOME already have the <code>ibus</code> package installed.}}
 '''After setup has been complete, restart your computer to ensure the changes take effect.'''