aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTeddy Wing2018-11-21 21:55:11 +0100
committerTeddy Wing2018-11-21 22:02:34 +0100
commit77bb59f63a51c5b70ae9ae2baf7c003e97f6cfa1 (patch)
treeef1e1c3fe6dae85b1129a257120bf579d92a4c65
parentce409d3c674853daf0c49aafbc8f20bd340ce2a3 (diff)
downloaddome_key_event_source_simulator-77bb59f63a51c5b70ae9ae2baf7c003e97f6cfa1.tar.bz2
Add READMEv1.0
-rw-r--r--README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..64bd485
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+DomeKey Event Source Simulator
+==============================
+
+A Mac library that simulates NX keys, as defined in
+[`/System/Library/Frameworks/IOKit.framework/Versions/A/Headers/hidsystem/ev_keymap.h`][1].
+
+This makes it possible to simulate media keys, for example, and other special
+function-row keys.
+
+The library provides a C interface for compatibility with non-Objective-C code.
+
+
+## Building
+Run the following to build static library `libdome_key_event_source_simulator.a`
+in Xcode’s DerivedData path:
+
+ $ make build-release
+
+The library is designed to work on Mac OS X 10.6 and later.
+
+
+## License
+Copyright © 2018 Teddy Wing. This project is part of [DomeKey][2], and is
+published under the same license (see the included LICENSE file).
+
+
+[1]: https://opensource.apple.com/source/IOHIDFamily/IOHIDFamily-86.1/IOHIDSystem/IOKit/hidsystem/ev_keymap.h
+[2]: https://domekey.teddywing.com/