Readme Update

Author: gitdev-bash

README.md

@@ -0,0 +1,75 @@
+# Piduck
+Piduck is a program with which you can easily use your Raspberry Pi Zero as a USB HID keyboard. It uses the scripting language [Ducky-Script-v1].
+
+## Setup
+### HID Setup
+[Source1][Hid-setup-source1]
+[Source2][Hid-setup-source2]  
+All commands have to be run as root!
+#### Modules & Drivers
+`echo "dtoverlay=dwc2" >> /boot/config.txt`
+
+`echo "dwc2" >> /etc/modules`
+
+`echo "libcomposite" >> /etc/modules`
+#### Configuration
+`touch /usr/bin/virtusb`
+
+`chmod +x /usr/bin/virtusb`
+
+`cat > /usr/bin/virtusb`
+```
+#!/bin/bash
+cd /sys/kernel/config/usb_gadget/
+mkdir -p virtusb
+cd virtusb
+echo 0x1d6b > idVendor # Linux Foundation
+echo 0x0104 > idProduct # Multifunction Composite Gadget
+echo 0x0100 > bcdDevice # v1.0.0
+echo 0x0200 > bcdUSB # USB2
+mkdir -p strings/0x409
+echo "virtusb638429573" > strings/0x409/serialnumber
+echo "virtusb" > strings/0x409/manufacturer
+echo "virtusb USB Device" > strings/0x409/product
+mkdir -p configs/c.1/strings/0x409
+echo "Config 1: ECM network" > configs/c.1/strings/0x409/configuration
+echo 250 > configs/c.1/MaxPower
+
+# Add functions here
+mkdir -p functions/hid.usb0
+echo 1 > functions/hid.usb0/protocol
+echo 1 > functions/hid.usb0/subclass
+echo 8 > functions/hid.usb0/report_length
+echo -ne \\x05\\x01\\x09\\x06\\xa1\\x01\\x05\\x07\\x19\\xe0\\x29\\xe7\\x15\\x00\\x25\\x01\\x75\\x01\\x95\\x08\\x81\\x02\\x95\\x01\\x75\\x08\\x81\\x03\\x95\\x05\\x75\\x01\\x05\\x08\\x19\\x01\\x29\\x05\\x91\\x02\\x95\\x01\\x75\\x03\\x91\\x03\\x95\\x06\\x75\\x08\\x15\\x00\\x25\\x65\\x05\\x07\\x19\\x00\\x29\\x65\\x81\\x00\\xc0 > functions/hid.usb0/report_desc
+ln -s functions/hid.usb0 configs/c.1/
+# End functions
+
+ls /sys/class/udc > UDC
+
+
+```  
+Press Ctrl-D to exit  
+`reboot` reboot to activate the changes
+### Install
+Also run these commands as root!
+
+`mkdir /etc/piduck`
+
+`wget -O /etc/piduck/piduck.py https://raw.githubusercontent.com/gitdev-bash/piduck/main/piduck.py`
+
+`chmod 555 /etc/piduck/piduck.py`
+
+`ln -s /etc/piduck/piduck.py /usr/bin/piduck`
+## Usage
+Root is needed (again)
+### Using Script File
+`piduck inject.txt`
+### Input from standard input
+`piduck`
+
+## Disclamer
+
+
+[Ducky-Script-v1]: https://github.com/hak5darren/USB-Rubber-Ducky/wiki/Duckyscript
+[Hid-setup-source1]: https://randomnerdtutorials.com/raspberry-pi-zero-usb-keyboard-hid/
+[Hid-setup-source2]: https://www.isticktoit.net/?p=1383