Skip to content

Commit

Permalink
Merge PR mumble-voip#4522: MAINT(docs): move and improve global short…
Browse files Browse the repository at this point in the history
…cuts instructions and explanation
  • Loading branch information
davidebeatrici authored Oct 8, 2020
2 parents 82cfcb8 + 50e1902 commit 72b0257
Show file tree
Hide file tree
Showing 3 changed files with 45 additions and 18 deletions.
18 changes: 0 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

45 changes: 45 additions & 0 deletions docs/GlobalShortcuts.md
Original file line number Diff line number Diff line change
@@ -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)
Binary file added screenshots/macOS_privacy_accessibility.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 72b0257

Please sign in to comment.