Configuration

If you installed the project using make then the config file should be located under /etc/duckydd/duckydd.conf.

The file format is as follows: <parameter> <option>

Detection:

minavrg 0s 7327733ns

Sets the minimum average time difference between keystrokes. If the minimum average of the currently typed string is smaller than the set value then the score will be incremented. The default minavrg was calculated using tests from the bash bunny and the maldruino elite. It should provide reasonable protection against the two.

maxscore 0

The so-called "score" of an event file is an internal variable which depicts how dangerous the HID device is. If the daemon increments the score over the set maxscore and a key is pressed then it will grab the file descriptor that was opened and thereby block any further keystrokes from being received by any other program that was listening for events.

At the moment it is incremented if a device: with the same major and minor id registers as a input device and a virtual com port. types faster than the allowed maximum average.

After the keyboard has been locked you have to replug it to unlock it.

usexkeymaps 1

If this option is enabled the daemon will first try to initialize the x dependent key map. If the use of the x keymap fails then the daemon falls back to kernel key maps. At the moment the use of the kernel key maps is experimental although alphanumeric characters of the English language work.

Logging:

logpath /

Sets the path where every log file is saved in.

If the process is passed the -d flag (daemonize) then it will also write its log messages to a file which is called out.log in the logpath directory.

Otherwise it will just use the directory for the key log file which is called key.log.

Note: You have to set a full path because the daemon has to be started as root. Currently the parser does not expand the string using environment variables.