{"id":20995367,"url":"https://github.com/todbot/mac-hid-dump","last_synced_at":"2025-05-14T21:31:14.690Z","repository":{"id":45738398,"uuid":"334037849","full_name":"todbot/mac-hid-dump","owner":"todbot","description":"Sort of a MacOS version of `usbhid-dump` to show HID Report Descriptors","archived":false,"fork":false,"pushed_at":"2021-01-29T05:19:34.000Z","size":7,"stargazers_count":48,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-08T02:18:26.544Z","etag":null,"topics":["hid","hid-device","hid-report-descriptor","macos","macosx","report","usb","usb-hid"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/todbot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-29T04:31:38.000Z","updated_at":"2025-01-25T17:17:27.000Z","dependencies_parsed_at":"2022-09-01T23:11:06.243Z","dependency_job_id":null,"html_url":"https://github.com/todbot/mac-hid-dump","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todbot%2Fmac-hid-dump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todbot%2Fmac-hid-dump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todbot%2Fmac-hid-dump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todbot%2Fmac-hid-dump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/todbot","download_url":"https://codeload.github.com/todbot/mac-hid-dump/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254230866,"owners_count":22036258,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hid","hid-device","hid-report-descriptor","macos","macosx","report","usb","usb-hid"],"created_at":"2024-11-19T07:23:25.763Z","updated_at":"2025-05-14T21:31:10.741Z","avatar_url":"https://github.com/todbot.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mac-hid-dump\n\n`mac-hid-dump` is a small command-line app to output the __HID Report Descriptors__ of all connected HID devices.  Think of it as sort of a MacOS version of [`usbhid-dump`](https://github.com/DIGImend/usbhid-dump). It is designed to inspect HID devices for use with [`hidapi`](https://github.com/libusb/hidapi/), [`node-hid`](https://github.com/node-hid/node-hid), or similar HID libraries.  The output can be parsed directly by the [USB Descriptor Parser](https://eleccelerator.com/usbdescreqparser/).\n\n`mac-hid-dump` uses some of the Mac-specific code from [libusb/hidapi](https://github.com/libusb/hidapi/), a cross-platform library for communicating with HID devies.  It is not dependent on `hidapi` though.\n\n\n## Usage:\n\nTo use `mac-hid-dump`, download the zip file from the Releases page, unzip it, and run it.\n\nWhen run, its output looks like the below.\n\n```\ntod@demo ~/Downloads/mac-hid-dump$ ./mac-hid-dump\nmac-hid-dump:\n16C0 0486:  - Teensyduino RawHID Device\nDESCRIPTOR:\n  06  c9  ff  09  04  a1  5c  75  08  15  00  26  ff  00  95  40\n  09  75  81  02  95  20  09  76  91  02  95  04  09  76  b1  02\n  c0\n  (33 bytes)\n16C0 0486:  - Teensyduino RawHID Device\nDESCRIPTOR:\n  06  ab  ff  0a  00  02  a1  01  75  08  15  00  26  ff  00  95\n  40  09  01  81  02  95  40  09  02  91  02  c0\n  (28 bytes)\n27B8 01ED: ThingM - blink(1) mk3\nDESCRIPTOR:\n  06  ab  ff  0a  00  20  a1  01  15  00  26  ff  00  75  08  85\n  01  95  08  09  00  b2  02  01  75  08  85  02  95  3c  09  00\n  b2  02  01  c0\n  (36 bytes)\ntod@demo ~/Downloads/mac-hid-dump$\n\n```\n\nThis example shows a\n[Teensy RawHID](https://www.pjrc.com/teensy/rawhid.html) and a [blink(1) USB LED](https://blink1.thingm.com/).  The Teensy RawHID descriptor shows a simple \"RawHID\" example of a single 64-byte report using no reportIDs for both Input and Output. The blink(1) descriptor shows an example that defines two reportID-based Feature reports: an 8-byte one and a 60-byte one.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftodbot%2Fmac-hid-dump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftodbot%2Fmac-hid-dump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftodbot%2Fmac-hid-dump/lists"}