From b12644ac56f5294fed837a3c485366586dd151fc Mon Sep 17 00:00:00 2001 From: Ben Reaves Date: Tue, 30 Jul 2019 21:33:44 -0500 Subject: [PATCH 1/2] - Updated readme with info about a usb hub bug. --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0540955..2d4e1cf 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,21 @@ sudo apt install python3.6 ``` ## Troubleshooting -If your keyboard is not being autodetected and configured then please run `xinput list`, if you are on linux, and copy the output into a ticket under issues. +If your keyboard is not being autodetected and configured then please run `xinput list`, if you are on linux, and copy the output into a ticket under issues. + +## Known Issues + +### USB Hubs + +USB hubs may prevent Apple branded keyboards from loading properly or other Apple specific keyboards that are intended to make use of the "hid_apple" driver. Without this driver it is not possible to run the following command and have it swap alt and cmd. + +``` +echo '1' | sudo tee -a /sys/module/hid_apple/parameters/swap_opt_cmd +``` + +This is required so that Apple and Windows keyboards can co-exist with the exact same keymappings, provided by setxkbmap. The solution for now is to avoid using a usb hub for your keyboard. Other possible solutions may be finding a way to patch the hid_apple module to accept other vendor and product id's so that it will still load the driver properly. + +Other solutions may involve implementing a separate Mac system option in Kinto with a keyswap specific to a usb hub situation, however it will not be possible to have a Windows keyboard (aka internal laptop keyboard) working with the same keymap at the same time. ## Contributing From 6cfd0642d885a960aabcec7c44baf82558f39ac6 Mon Sep 17 00:00:00 2001 From: Ben Reaves Date: Wed, 31 Jul 2019 02:09:50 -0500 Subject: [PATCH 2/2] Update README.md - Updated readme --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 2d4e1cf..d8f4ee6 100644 --- a/README.md +++ b/README.md @@ -27,13 +27,14 @@ Remaps your keyboard to behave more like you're on a mac again and below is how ``` git clone https://github.com/rbreaves/kinto.git ``` -2. Install python3 (If needed, most current distros have it already) +2. Install python3 (If needed) -Debian or Ubuntu 16.04 +Debian or Ubuntu 16.04 or 18.04 ``` sudo apt update -sudo apt install python3.6 +sudo apt install python3 ``` + 3. Follow the prompts and the script will guide you through the rest of the setup. ``` ./install.py