karabiner-virtualhiddevice-archived's Introduction

Karabiner-VirtualHIDDevice

Karabiner-VirtualHIDDevice is a virtual HID device driver for macOS.

A virtual keyboard device implementation for macOS.
- Keyboard/Keypad Usage Page is supported.
- Consumer Usage Page is supported.
- AppleVendor Usage Page (fn key, Mission Control key, Launchpad key, etc.) is supported.
A virtual pointing device (mouse) implementation for macOS.

Supported systems

macOS Sierra (10.12)
macOS High Sierra (10.13)
macOS Mojave (10.14)
macOS Catalina (10.15)

How to build

System requirements:

macOS 10.13
Xcode 8.3.3 (required for macOS 10.12 support)
Command Line Tools for Xcode

Step 1: Getting source code

Clone the source from github.

git clone --depth 1 https://github.com/pqrs-org/Karabiner-VirtualHIDDevice.git

Step 2: Building a package

cd Karabiner-VirtualHIDDevice
make

The make script will create a redistributable kext into dist directory.

Example

example/virtual_keyboard_example
example/virtual_pointing_example

Usage

Execute the following instructions in Terminal.

Install VirtualHIDDevice.kext by make install in the top directory.
cd example/virtual_pointing_example
make
make run

Acknowledgments

Karabiner-VirtualHIDDevice uses the Vendor ID and Product ID from Objective Development. https://github.com/obdev/v-usb/blob/master/usbdrv/USB-IDs-for-free.txt

karabiner-virtualhiddevice-archived's People

Contributors

Stargazers

Watchers

karabiner-virtualhiddevice-archived's Issues

F1, F2, etc. always act as standard function keys (never as the labeled special features)

In system preferences, there is a checkbox labeled:

Use F1, F2, etc. keys as standard function keys
When this option is selected, press the Fn key to use the special features printed on each key.

Regardless of whether this box is checked or not, and regardless of whether Fn is held, the function keys always act as standard function keys.

For example, when I add kHIDUsage_KeyboardF1 to an hid_report::input_report and post it with post_keyboard_input_report, then my desktop environment still receives an F1 keypress (as opposed to a brightness_decrement keypress). All other keys work as expected, and can be properly modified with Fn as a modifier.

Is this the expected behavior of the virtual hid device?

Recommend Projects