mirror of https://github.com/pikvm/pikvm
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# Mouse modes
|
|
|
|
There are two modes of pointer device: absolute and relative.
|
|
|
|
In absolute mode, the input device transmits the exact coordinates (X,Y) where the cursor should be moved. This is how touchscreens or drawing tablets work.
|
|
|
|
In relative mode, only the relative offset (dX,dY) to the current position is transmitted, which is unknown to the input device itself. This is a regular mouse.
|
|
|
|
By default, Pi-KVM uses absolute positioning mode as the most convenient for the user and software.
|
|
However, this is not always supported by the BIOS/UEFI.
|
|
For such cases, support is provided for the relative mode of operation, which can be enabled in the config.
|
|
|
|
When using relative mode, the browser will exclusively capture your mouse when you click on the stream window in Pi-KVM once.
|
|
When you press `Esc`, the browser releases the mouse.
|
|
|
|
:exclamation: Currently, the relative mouse mode is not supported by [Pi-KVM VNC server](vnc.md) yet.
|
|
The reason is that none of the recommended clients support the [QEMU Pointer Motion Change](https://github.com/rfbproto/rfbproto/blob/master/rfbproto.rst#qemu-pointer-motion-change-pseudo-encoding) extension.
|
|
We expect to implement this in [TigerVNC](https://github.com/TigerVNC/tigervnc/issues/619).
|
|
|
|
:exclamation: The relative mode is also not supported by mobile browsers.
|
|
|
|
# Enabling the relative mouse on the v2 platform (OTG HID)
|
|
* Switch filesystem to RW-mode using command `rw`.
|
|
* Edit `/etc/kvmd/override.yaml` and add these lines:
|
|
```yaml
|
|
kvmd:
|
|
hid:
|
|
mouse:
|
|
absolute: false
|
|
```
|
|
* Perform `reboot`. After that reboot your PC.
|
|
* If the mouse is still not detected by the BIOS/UEFI, try disabling horizontal scrolling to achieve the maximum compatibility:
|
|
```yaml
|
|
kvmd:
|
|
hid:
|
|
mouse:
|
|
absolute: false
|
|
horizontal_wheel: false
|
|
```
|
|
* Don't forget to perform `reboot`.
|
|
|
|
# Enabling the relative mouse on the v0 platform (serial HID)
|
|
:exclamation: This is not currently supported but will be added in a future release. The reason is that we are working on improving the HID protocol.
|