diff --git a/Immune-Keys.md b/Immune-Keys.md new file mode 100644 index 0000000..98c3d35 --- /dev/null +++ b/Immune-Keys.md @@ -0,0 +1,32 @@ +# Immune Keys + +## Overview + +### What are Immune Keys? +Immune keys are keyboard keys that Barrier will not forward to other PCs. They are "immune" from being blocked on the host (server). + +### Why would I want them? +You probably don't. Barrier works best when your keyboard and mouse function as if they were physically attached to every connected client. There are situations, however, in which a user might not want a certain key or keys forwarded. In this case you would simply list them as immune keys and they will always pass directly to the host machine and never to a client. + +### What are the requirements? +At this time Immune Keys are a Windows-only feature; your keyboard must be connected to a Windows machine. + +## Immune Keys Procedure + +- Check [this table](https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx) for the virtual key code value of the key you want to immune. +- Create or open ImmuneKeys.txt inside the C:\Users\USERNAME\AppData\Local\Barrier folder. +- Add one line per key to this file, save it, and close it. + - Each line starts with a keycode in decimal or hexadecimal and can follow with human-readable text to use as a comment field. + - Any line that starts with a # is considered a comment line and is ignored. Blank lines are also ignored. +- Restart host server from the Barrier GUI (click Stop, then Start) to effect your changes. + +# Example Configuration + + # this is a comment line. describe the reason for the follow immune key here. + + # prevent Escape key from being forwarded to clients + 0x1B + + # you can also add comments after the keycode column. everything after the keycode is ignored so no # is required + + 163 VK_RCONTROL (0xA3) for discord muting