Plover-uinput: Difference between revisions

Revision as of 00:18, 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:

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.

Navigate to the folder containing the AppImage.
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.
Restart Plover.
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

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

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 10: / Line 10: @@
 # Navigate to the folder containing the AppImage.
-# Run <code>./plover-4.0.0rc2+6.g53c416f-x86_64.AppImage -s plover_plugins install plover-uinput</code>.
+# Run the following command: <pre>./plover-4.0.0rc2+6.g53c416f-x86_64.AppImage -s plover_plugins install plover-uinput</pre>
 #* Note that the executable may be different if you're running a different version of Plover, or if you're not using the AppImage.
 # Restart Plover.
@@ Line 20: / Line 20: @@
 Add your user to the <code>input</code> group with the following command:
-<code>sudo usermod -aG input $USER</code>
+<pre>sudo usermod -aG input $USER</pre>
 Create a file at <code>/etc/udev/rules.d/90-plover-uinput.rules</code> with the following content:
-<code>KERNEL=="uinput", GROUP="input", MODE="0660", OPTIONS+="static_node=uinput"</code>
+<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>.