snosrap / xpc_set_event_stream_handler

Consume a com.apple.iokit.matching event, then run the executable specified in the first parameter.

xpc_set_event_stream_handler

Consume a com.apple.iokit.matching event, then run the executable specified in the first parameter.

This is useful when creating launchd LaunchAgents that are triggered by IO events (e.g., run a script when keyboard/mouse attached). Failing to consume the com.apple.iokit.matching event will result in the executable being called repeatedly.

This isn't really documented anywhere other than the man page for xpc_set_event_stream_handler.

Example Property List

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>Label</key>
	<string>com.example.KeyboardAttach</string>
	<key>ProgramArguments</key>
	<array>
		<string>/usr/local/bin/xpc_set_event_stream_handler</string>
		<string>/usr/local/bin/KeyboardAttachScript.sh</string>
	</array>
	<key>LaunchEvents</key>
	<dict>
		<key>com.apple.iokit.matching</key>
		<dict>
			<key>com.example.KeyboardAttach.Event</key>
			<dict>
				<key>idVendor</key>
				<integer>1234</integer>
				<key>idProduct</key>
				<integer>56789</integer>
				<key>IOProviderClass</key>
				<string>IOUSBDevice</string>
				<key>IOMatchLaunchStream</key>
				<true/>
			</dict>
		</dict>
	</dict>
</dict>
</plist>

xpc_set_event_stream_handler's Issues

Using it with BLUETOOTH audio device?

How I can detect the BLE connect/disconnect?

Says in your doc:
IOProviderClass should be either IOPCIDevice (Thunderbolt) or IOUSBDevice (USB).

Would you mind adding a license?

This is useful for people who want to remap keys using hidutil.

I want to package this and add it to https://github.com/NixOS/nixpkgs, but according to the source file, this is not permitted.

xpc_set_event_stream_handler/xpc_set_event_stream_handler/main.m

Line 6 in 5382ab7

// Copyright © 2017 Ford Parsons. All rights reserved.

Would you consider licensing this under MIT or similar?

Complied Binary Does Not Work on Apple Silicon

I have tried re-compiling this on Apple Silicon, as Universal Binary, ARM64, and Intel X64. None of them actually appear to function. I've tried signing it with a Self Signed cert, and also tried with an Apple Developer Account cert. No combination seems to get it to work on Apple Silicon when re-compiled. A version I compiled 2 years ago on 10.15 Catalina Intel continues to work fine via Rosetta. Am I missing something?