A USB/IP client for macOS.
Attaching a device uses IOUSBHostControllerInterface, which needs one of:
- an app bundle signed with the
com.apple.developer.usb.host-controller-interfaceentitlement and a provisioning profile that grants it - SIP disabled, running as root
- SIP disabled, the
amfi_get_out_of_my_way=1boot-arg, and an ad-hoc signature claiming the entitlement:codesign --force --sign - --entitlements entitlements.plist usbip.app
Opening usbip.app puts an icon in the menu bar. Add a server, then click an exported device to attach it and click it again to detach it.
usbip-macos -r <server> list
sudo usbip-macos -r <server> attach --busid 1-1.4The app bundle's executable is the same CLI when run with arguments:
/Applications/usbip.app/Contents/MacOS/usbip-macos -r <server> list- Isochronous devices (most webcams, microphones and speakers) don't work. This is a macOS limitation:
IOUSBHostControllerInterfacedoesn't properly support isochronous transfers. - UAS disks work, but only as plain mass storage. This is also a macOS limitation:
IOUSBHostControllerInterfacedoesn't support the bulk streams UAS needs.