HID-RECORDER(1)

📦
version 0.12 · 4 versions
, in arch rolling

💖 NAME 💖

hid-recorder — the HID input device recorder, bestie. That's it, that's the whole vibe.

✨ SYNOPSIS ✨

hid-recorder [--output=output_file] [/dev/hidrawX] [[/dev/hidrawX] [...]]

🎀 OPTIONS 🎀

  • --output=path/to/file — sends the output into the file you name here instead of your terminal. Omit it and hid-recorder just prints to stdout like a normal little icon. 🫶

🌸 DESCRIPTION 🌸

okay so. hid-recorder captures report descriptors and hid reports (aka events) coming through the hidraw kernel module, then prints them all in a standardized format (scroll down, it's the next section, iykyk) so you can debug HID devices and replay them later. it's giving forensic girlboss energy fr fr.

run it with no arguments at all and it just shows you a list of the available devices — a little menu moment, we love to see it. 💅

heads up though: hid-recorder has to be able to read from the hidraw device. usually that means it must be run as root. no cap, the permissions check does not care about your feelings 😭

🦋 FILE FORMAT 🦋

the output of hid-recorder follows this syntax, and these prefixes are exactly what the parser looks for, so don't get creative with them:

  • # — comment lines, ignored when parsing (your little margin notes, they see nothing)
  • D: — the device index; only used when you're recording multiple devices
  • R: — the report descriptor length in bytes, followed by the report descriptor bytes in hexadecimal
  • N: — the name of the device
  • P: — physical path
  • I: — bus vendor_id product_id
  • E: — timestamp size report in hexadecimal

💀 EXIT CODE 💀

hid-recorder returns 1 on error. that's the whole mood: chill when it works, 1 when it does not.

🔥 SEE ALSO 🔥

Copyright 2012-2018, Benjamin Tissoires.

Copyright 2018, Red Hat, Inc.

🌈 AUTHOR 🌈

Benjamin Tissoires benjamin.tissoires@redhat.com

and that's the page bestie, go record some reports 💜 — this one lives in the General Commands Manual, and the footer tag on it is literally just HID-RECORDER(1), signed off with the copyright years up above ✨💅

📦 where this page comes from