# hak5/usbrubberducky-payloads

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/hak5-usbrubberducky-payloads).**

5,537 stars · 1,619 forks · PowerShell

## Links

- GitHub: https://github.com/hak5/usbrubberducky-payloads
- Homepage: https://usbrubberducky.com
- awesome-repositories: https://awesome-repositories.com/repository/hak5-usbrubberducky-payloads.md

## Topics

`badusb` `ducky-payloads` `duckyscript` `hacking-tools` `hak5` `hak5-rubber-ducky` `hid` `hotplug` `keystroke-injection` `payloads` `pentesting` `security-tools` `usb-rubber-ducky` `usbrubberducky`

## Description

This repository is a library of scripts for automating keystroke injection and executing remote payloads via USB HID devices. It provides a collection of pre-written automation sequences that simulate keyboard input to perform complex tasks on target operating systems.

The framework supports cross-platform payloads capable of detecting target operating systems and adapting keyboard layouts for accurate character injection across different regions. It utilizes a staged payload method to download and execute external code from remote servers, extending the functionality of initial scripts.

The project includes modular automation logic consisting of reusable helper functions and extensions. It covers physical penetration testing capabilities through the use of conditional control flow and regional language mapping to ensure reliability across diverse hardware and software environments.

## Tags

### Development Tools & Productivity

- [Keyboard Automation](https://awesome-repositories.com/f/development-tools-productivity/input-pointer-automation/keyboard-automation.md) — Executes pre-written scripts to simulate keyboard input for performing complex tasks on target systems. ([source](https://github.com/hak5/usbrubberducky-payloads/blob/master/README.md))
- [Input Sequence Specifications](https://awesome-repositories.com/f/development-tools-productivity/automation-scripts/input-sequence-specifications.md) — Provides a structured format for defining the precise keystrokes and timing delays used in HID injection.
- [Keystroke Logging](https://awesome-repositories.com/f/development-tools-productivity/input-pointer-automation/input-automation/remote-input-simulation/remote-input-controllers/keystroke-logging.md) — Provides pre-written automation sequences that simulate keyboard input to perform complex tasks.
- [Remote Logic Loading](https://awesome-repositories.com/f/development-tools-productivity/external-configuration-loading/remote-logic-loading.md) — Fetches external executable bundles from remote servers to update payload logic without local storage limits.
- [Modular Library Extensions](https://awesome-repositories.com/f/development-tools-productivity/modular-library-extensions.md) — Provides reusable libraries of predefined functions and variables to extend payload capabilities.

### Security & Cryptography

- [USB Keystroke Injection Scripts](https://awesome-repositories.com/f/security-cryptography/usb-keystroke-injection-scripts.md) — Provides a comprehensive library of scripts for automating keystroke injection and executing remote payloads via USB HID devices.
- [Multi-Stage Payload Delivery](https://awesome-repositories.com/f/security-cryptography/multi-stage-payload-delivery.md) — Implements a sequenced delivery chain that downloads and executes external code from remote servers to extend initial script functionality. ([source](https://github.com/hak5/usbrubberducky-payloads/blob/master/README.md))
- [Remote Script Execution](https://awesome-repositories.com/f/security-cryptography/remote-script-execution.md) — Uses initial scripts to download and execute additional system-level code from a remote source.
- [Penetration Testing Suites](https://awesome-repositories.com/f/security-cryptography/security/utilities/security-tools/offensive-red-team/offensive-security-frameworks/penetration-testing-suites.md) — Provides a suite of tools and scripts to simulate unauthorized physical access via USB HID devices for security testing.

### Hardware & IoT

- [Cross-Platform Payloads](https://awesome-repositories.com/f/hardware-iot/hid-emulations/keyboard-payloads/cross-platform-payloads.md) — Ships scripts that detect target operating systems and adapt keyboard layouts for accurate cross-region injection.
- [Keyboard Layout Mappings](https://awesome-repositories.com/f/hardware-iot/keyboard-layout-mappings.md) — Uses regional keyboard definition files to map characters to the correct scan codes for diverse hardware layouts.
- [Modular HID Logic](https://awesome-repositories.com/f/hardware-iot/hid-emulations/modular-hid-logic.md) — Provides a set of reusable helper functions and extensions to simplify the creation of complex injection sequences.
- [Keyboard Layout Mapping](https://awesome-repositories.com/f/hardware-iot/keyboard-layout-mapping.md) — Adapting automated keystrokes to match different regional language layouts so characters are entered correctly on any system.

### Operating Systems & Systems Programming

- [OS-Specific Keystroke Sequences](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/system-programming-primitives/system-abstractions/os-specific-integration-modules/os-specific-keystroke-sequences.md) — Detects the target operating system to trigger unique keystroke sequences tailored to that environment.
- [OS-Adaptive Automation](https://awesome-repositories.com/f/operating-systems-systems-programming/os-adaptive-automation.md) — Creates scripts that detect the target operating system to ensure the correct keystrokes are sent.
- [Runtime OS Detection](https://awesome-repositories.com/f/operating-systems-systems-programming/runtime-os-detection.md) — Identifies the target system's operating system to execute appropriate, tailored keystroke sequences. ([source](https://github.com/hak5/usbrubberducky-payloads/blob/master/README.md))
- [Keystroke Emulators](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-emulation/keystroke-emulators.md) — Simulates native keyboard input to inject text and execute commands on target applications via USB.

### User Interface & Experience

- [Keyboard Layout Configurations](https://awesome-repositories.com/f/user-interface-experience/component-utilities/keyboard-shortcuts/keyboard-layout-configurations.md) — Uses language files to ensure keystrokes map correctly across different regional keyboard settings. ([source](https://cdn.jsdelivr.net/gh/hak5/usbrubberducky-payloads@master/README.md))

### Part of an Awesome List

- [Payload Logic Structures](https://awesome-repositories.com/f/awesome-lists/devtools/payload-generators-and-fuzzers/payload-logic-structures.md) — Provides loops, functions, and conditional constructs to create dynamic payloads that adapt to target states. ([source](https://cdn.jsdelivr.net/gh/hak5/usbrubberducky-payloads@master/README.md))

### Software Engineering & Architecture

- [Script Control Flow](https://awesome-repositories.com/f/software-engineering-architecture/execution-flow-control/script-control-flow.md) — Implements loops and if-then logic within scripts to adapt execution based on the target machine state.
