diff --git a/README.md b/README.md index a07b08344..e2f2cd67d 100644 --- a/README.md +++ b/README.md @@ -106,21 +106,3 @@ To load a game with the overlay enabled, start the game like this: If you have Mumble installed through the binary packages, this can be done by simply typing: mumble-overlay gamename - -### Global Keyboard Events - -On Linux, Mumble supports reading the kernel input devices. To use this, -make sure mumble can open `/dev/input/event*` for reading. To test it out, -that should only require: - -``` - sudo chmod a+r /dev/input/event* -``` - -However, be aware that this will most likely only last until the next reboot -(at which point devfs is recreated) and you also allow any program run by any -user to monitor the physical keyboard. - -Without this, Mumble will continuously poll the mouse and keyboard state for -changes, which will use a tiny bit of processing power. - diff --git a/docs/GlobalShortcuts.md b/docs/GlobalShortcuts.md new file mode 100644 index 000000000..42ef74946 --- /dev/null +++ b/docs/GlobalShortcuts.md @@ -0,0 +1,45 @@ +# Global shortcuts + +## Windows + +No additional steps should be required. + +If you're encountering problems, feel free to open an issue. + +## Linux + +### Poll-driven engine + +Uses a little more processing power, but no additional steps are required. + +### Event-driven engine + +Mumble needs read permissions for `/dev/input/event*`. + +The solution usually consists in adding your user to the `input` group: + +``` +sudo usermod -a -G input user +``` + +Please note that this allows any applications running under the same user +to read data sent by input devices. + +If the solution doesn't work for you, you could allow all users to read the input: + +``` + sudo chmod a+r /dev/input/event* +``` + +Please note that this is only meant to be a temporary solution, because: + +- It will most likely only last until the next reboot +(at which point devfs is recreated). +- It allows any applications to read the input data, +regardless of the user they're running under! + +## macOS + +Mumble needs to be granted accessibility permissions. + +![macOS screenshot](../screenshots/macOS_privacy_accessibility.png) diff --git a/screenshots/macOS_privacy_accessibility.png b/screenshots/macOS_privacy_accessibility.png new file mode 100644 index 000000000..7988cf090 Binary files /dev/null and b/screenshots/macOS_privacy_accessibility.png differ