This directory is for developer helper scripts, like those used to automate
the creation of controller layouts.


## Dummy HID Device (Linux only)

If you ever need a dummy HID device to test mapping capabilities or introspect reports set by a mapping for example, you can build a dummy one using `dummy_hid_device.c`. Note that you will need `uhid` to use this daemon.

Here is how to get the daemon setup. Make sure to do this **before** Mixxx is started

```sh
# Enable UHID
sudo modprobe uhid
# This next command assumes you are running it from the Mixxx directory
#  Optionally, you can pass:
#    `-DVENDOR_ID=0x1234` to customize vendor ID
#    `-DPRODUCT_ID=0x1234` to customize product ID
#    `-DDEVICE_NAME="My Device"` to customize the device name
cd build && gcc ../tools/dummy_hid_device.c -lhidapi-hidraw -o dummy_hid_device && sudo ./dummy_hid_device
# Allow the created hidraw device to be accesssed by the user. You may also set the write udev rules. Finally, you can also run Mixxx as root, but that's not recommended.
sudo chown "$USER" "$(ls -1t /dev/hidraw* | head -n 1)"
```