Skip to content

Commit 4851295

Browse files
committed
docs: document change to use uinput only
1 parent 1c0dc79 commit 4851295

File tree

4 files changed

+5
-10
lines changed

4 files changed

+5
-10
lines changed

docs/installation.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,6 @@ First install pip, and then run
1212
This will not install the Solaar udev rule, which you will need to install manually by copying
1313
`~/.local/lib/udev/rules.d/42-logitech-unify-permissions.rules`
1414
to `/etc/udev/rules.d` as root.
15-
If you want Solaar rules to simulate input you will have to instead install Solaar's uinput udev rule
16-
from the GitHub repository.
1715

1816
## Installing in macOS
1917

@@ -52,8 +50,6 @@ First, install the needed system packages by `make install_apt`
5250
or `make install_dnf` or `make install_brew`.
5351
These might not install all needed packages in older versions of your distribution.
5452
Next, install the Solaar rule via `make install_udev`.
55-
If you are using Wayland instead of X11 you may want to instead `make install_udev_uinput`
56-
so that Solaar rules can simulate input in Wayland.
5753
Finally, install Solaar via `make install_pip` or `make install_pipx`.
5854

5955
Parts of the installation process require sudo privileges so you may be asked for your password.
@@ -129,8 +125,6 @@ For more information see [the rules page](https://pwr-solaar.github.io/Solaar/ru
129125
You can install Solaar's udev rule manually by copying the file
130126
`rules.d/42-logitech-unify-permissions.rules`
131127
as root from the Solaar repository to `/etc/udev/rules.d`.
132-
In Wayland you may want to instead copy
133-
`rules.d-uinput/42-logitech-unify-permissions.rules`.
134128
Let udev reload its rules by running `sudo udevadm control --reload-rules`.
135129

136130
# Solaar in other languages

docs/issues.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ layout: page
4545
in some system tray implementations. Changing to a different theme may help.
4646
The `--battery-icons=symbolic` option can be used to force symbolic icons.
4747

48-
- Solaar will try to use uinput to simulate input from rules under Wayland or if Xtest is not available
48+
- Solaar uses uinput to simulate input
4949
but this needs write permission on /dev/uinput.
5050
For more information see [the rules page](https://pwr-solaar.github.io/Solaar/rules).
5151

docs/rules.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ although on GNOME desktop under Wayland, you can use those with the Solaar Gnome
1515
You can install it from `https://extensions.gnome.org/extension/6162/solaar-extension`.
1616
Under Wayland using keyboard groups may result in incorrect symbols being input for simulated input.
1717
Under Wayland simulating inputs when modifier keys are pressed may result in incorrect symbols being sent.
18-
Simulated input uses Xtest if available under X11 or uinput if the user has write access to /dev/uinput.
19-
The easiest way to maintain write access to /dev/uinput is to use Solaar's alternative udev rule by downloading
20-
`https://raw.githubusercontent.com/pwr-Solaar/Solaar/master/rules.d-uinput/42-logitech-unify-permissions.rules`
18+
Simulated input uses uinput to simulate input so the user has to have write access to /dev/uinput.
19+
The easiest way to maintain write access to /dev/uinput is to use Solaar's udev rule by downloading
20+
`https://raw.githubusercontent.com/pwr-Solaar/Solaar/master/rules.d/42-logitech-unify-permissions.rules`
2121
and copying it as root into the `/etc/udev/rules.d` directory.
2222
You may have to reboot your system for the write permission to be set up.
2323
Another way to get write access to /dev/uinput is to run `sudo setfacl -m u:${USER}:rw /dev/uinput`

rules.d/42-logitech-unify-permissions.rules

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
# Allows non-root users to have raw access to Logitech devices.
44
# Allowing users to write to the device is potentially dangerous
55
# because they could perform firmware updates.
6+
KERNEL=="uinput", SUBSYSTEM=="misc", TAG+="uaccess", OPTIONS+="static_node=uinput"
67

78
ACTION == "remove", GOTO="solaar_end"
89
SUBSYSTEM != "hidraw", GOTO="solaar_end"

0 commit comments

Comments
 (0)