> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/payload-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/payload-studio/getting-started/editing-basics.md).

# Editing Basics

Payload Development for all your Hak5 Gear has never been easier!

{% hint style="info" %}
**Don't worry**, you can always change the device mode while editing a payload!
{% endhint %}

## Changing Device / Editing mode

Changing editor modes is as easy as two clicks!&#x20;

1. Click the current device from the top left of the editor
2. Choose a new device mode from the Device Picker Menu

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fo5ht4Xz7I47F6uw6jP1N%2FScreenshot%20from%202023-01-30%2016-19-58.png?alt=media&amp;token=b129ae5c-8f17-441f-9f4e-f4fc66503c4d" alt=""><figcaption><p>Change editor mode</p></figcaption></figure>

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fiog8OkexajHuuPqEGrBi%2FScreencast%20from%2002-01-2023%2005_01_14%20PM.gif?alt=media&amp;token=b01a9c80-959f-4251-a7f4-a91ea33be978" alt=""><figcaption><p>Changing devices from the Device Picker</p></figcaption></figure>

Payload Studio supports the full line of Hak5 DuckyScript compatible devices:

## [USB Rubber Ducky](https://hak5.org/products/usb-rubber-ducky)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FNJwPrDJ2p8cNXz1AyncV%2FScreenshot%20from%202023-02-01%2018-34-36.png?alt=media&amp;token=4792352a-b34c-4cac-9914-8204ae3cd2c0" alt=""><figcaption></figcaption></figure>

The **NEW** USB Rubber Ducky supports DuckyScript 3.0 (and DuckyScript 1.0) with full features and compiled payloads!

[USB Rubber Ducky Documentation](https://docs.hak5.org/hak5-usb-rubber-ducky/)

{% hint style="info" %}

#### USB Rubber Ducky Original

The original USB Rubber Ducky continues to work with DuckyScript 1.0 features!
{% endhint %}

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FfdnwuRqAsVPSCSZWgmf3%2FScreenshot%20from%202023-02-01%2017-22-02.png?alt=media&amp;token=c4d4c80f-1ebc-455b-8b0b-797599acdb8f" alt=""><figcaption><p>USB Rubber Ducky Mode</p></figcaption></figure>

### Ducky Payload Deployment

When you're read to test or deploy your payload:

click ![Generate Payload button](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fl2SK4XOej8lPRLF9ZjYe%2FScreenshot%20from%202023-02-01%2017-58-15.png?alt=media\&token=49f5534b-9187-46bc-83b4-62dd854cf183) \
\
PayloadStudio will then take the `DuckyScript Source code` in the Editor and compile it into an `inject.bin`<br>

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FeFa7kJXOEciNkQrPyS1p%2FScreenshot%20from%202023-02-01%2017-59-00.png?alt=media&amp;token=c5a42a12-84ee-4bbd-b0b9-34a2c28bdc58" alt=""><figcaption><p>Compiling Notification</p></figcaption></figure>

PayloadStudio will automatically open the console. This is where the compiler will output any information regarding the compilation process and the resulting `inject.bin`

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F1IBlvXPxBG4CN8U9e2mM%2FScreenshot%20from%202023-02-01%2017-59-28.png?alt=media&amp;token=82f3f83e-0ab3-49ec-b0f5-4cfd373b6122" alt=""><figcaption><p>PayloadStudio Compiler output in the Console</p></figcaption></figure>

Below the console, if your payload compiled successfully, you'll find the **Result**

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FezGf9S0pQnjD4ib5MC3a%2Fimage.png?alt=media&amp;token=c33dee95-6212-4251-8388-e912c898c7ce" alt=""><figcaption><p>Generate Payload Result</p></figcaption></figure>

Here you can download the `inject.bin`

Download `inject.bin` ![Download button](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fkn9adj28AbHXoC0xRnPS%2FScreenshot%20from%202023-02-01%2018-04-33.png?alt=media\&token=7df2fa4c-6a3b-42a8-9713-f020924b081f)![Download Button on hover](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FQno1jsDb0V7dIHoHXzDa%2FScreenshot%20from%202023-02-01%2018-04-55.png?alt=media\&token=13c088c4-d53b-41db-814b-67cd01ff139d)

This dialog also provides the option to download **the source that generated** the `inject.bin` -- This *may differ from whats currently in the editor if you've made changes in the editor since compiling*

Download Source: ![Download Submenu](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FUHTFo1xeHH9ggm7ReiOI%2FScreenshot%20from%202023-02-01%2018-05-16.png?alt=media\&token=6c2dfe1e-fec5-4763-b78e-3a061f0c0804)![Download submenu > Download Source button](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F5UJ1xG6pRL6HqYn5CiYs%2FScreenshot%20from%202023-02-01%2018-05-37.png?alt=media\&token=ba19318a-1437-40e8-a155-9d92e74099dc)

From this sub-menu you may also discard the `inject.bin`

If you've made changes in the editor after clicking **Generate Payload** - PayloadStudio will notify you that the current editing session differs from the `inject.bin` and `payload.txt` available for download:

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FfiYaWJ28eW1a8S8nE7bG%2FScreenshot%20from%202023-02-01%2018-07-24.png?alt=media&amp;token=90f92294-107a-4bf7-bbd9-96bf3acb3a41" alt=""><figcaption><p>Uncompiled Changes display in the breadcrumbs</p></figcaption></figure>

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F5nvo7kIzHbDk9fxBahgt%2FScreenshot%20from%202023-02-01%2018-07-32.png?alt=media&amp;token=298ffc4c-f16e-4a65-86e8-aaefeb1625b1" alt=""><figcaption><p>Editor differs from available download</p></figcaption></figure>

{% hint style="info" %}
You can always download a copy of the current editor from **File >** **Save** ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FDqxYeM7wqBu4enAUjyos%2FScreenshot%20from%202023-02-01%2018-38-06.png?alt=media\&token=e0e9e480-d98a-44b6-8ff0-47cfcad8af2f)
{% endhint %}

## [Bash Bunny](https://hak5.org/products/bash-bunny)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FP2gUYbrYIzuPC56ldoom%2FScreenshot%20from%202023-02-01%2018-35-16.png?alt=media&amp;token=bfb3da87-8ca1-4518-a2ea-cb4aa5f336d9" alt=""><figcaption></figcaption></figure>

The Bash Bunny supports DuckyScript 2.0 + bash scripting

[Bash Bunny Documentation](https://docs.hak5.org/bash-bunny/)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FomVwc1BUR8wQNuw4VRNA%2FScreenshot%20from%202023-02-01%2017-22-20.png?alt=media&amp;token=0bcc9003-de6b-4986-9a40-5e27ec2589e5" alt=""><figcaption><p>Bash Bunny Mode</p></figcaption></figure>

### Bunny Payload Deployment

Click ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F471UdUTDDi4AGUANtx3B%2FScreenshot%20from%202023-02-01%2018-28-32.png?alt=media\&token=33482fcd-c961-499b-b0cd-2ebee1eebad4) or ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FlZkiaSrrbkRi9e09cs6Q%2FScreenshot%20from%202023-02-01%2018-38-06.png?alt=media\&token=f8ff9ca8-e79d-4d45-9c5f-0b3f8a5d9069)

Next, arm and transfer to the device - for more info see [Bash Bunny Documentation](https://docs.hak5.org/bash-bunny/)

## [Key Croc](https://hak5.org/products/key-croc)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FMNoj0y74vGMkWjKFTwiB%2FScreenshot%20from%202023-02-01%2018-35-25.png?alt=media&amp;token=924759d1-bb46-45bc-8bc0-2cfaedffdb83" alt=""><figcaption></figcaption></figure>

The Key Croc supports DuckyScript 2.0 + bash scripting

[Key Croc Documentation](https://docs.hak5.org/key-croc/)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fthwcs32oJ54J0kTmzzAT%2FScreenshot%20from%202023-02-01%2017-22-32.png?alt=media&amp;token=b88876b5-c5bc-44da-bac1-5f81e03398e3" alt=""><figcaption><p>Key Croc Mode</p></figcaption></figure>

### Croc Payload Deployment

Click ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F471UdUTDDi4AGUANtx3B%2FScreenshot%20from%202023-02-01%2018-28-32.png?alt=media\&token=33482fcd-c961-499b-b0cd-2ebee1eebad4) or ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F54Fbd1SU6fcMQhV0tXYu%2FScreenshot%20from%202023-02-01%2018-38-06.png?alt=media\&token=b16e2630-0501-402e-a3a4-227e6c6e3a93)

Next, arm and transfer to the device - for more info see [Key Croc Documentation](https://docs.hak5.org/key-croc/)

## [Shark Jack](https://hak5.org/products/shark-jack)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FU7gIfUtZO7gW8QMWrJgH%2FScreenshot%20from%202023-02-01%2018-35-31.png?alt=media&amp;token=d2d175fd-af94-444f-99b5-cb84e5203151" alt=""><figcaption></figcaption></figure>

The Shark Jack supports DuckyScript 2.0 + bash scripting

[Shark Jack Documentation](https://docs.hak5.org/shark-jack/)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Ftq36ZFF5342iAyJdn1Tb%2FScreenshot%20from%202023-02-01%2017-22-47.png?alt=media&amp;token=e0a45caa-9de8-42d6-b792-a17a58272e9c" alt=""><figcaption><p>Shark Jack Mode</p></figcaption></figure>

### Shark Payload Deployment

Click ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F471UdUTDDi4AGUANtx3B%2FScreenshot%20from%202023-02-01%2018-28-32.png?alt=media\&token=33482fcd-c961-499b-b0cd-2ebee1eebad4) or ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FQELjQrweA3O7qaLCFqQD%2FScreenshot%20from%202023-02-01%2018-38-06.png?alt=media\&token=4f0e2893-1984-4672-8fde-8880f9a77ad0)

Next, arm and transfer to the device - for more info see [Shark Jack Documentation](https://docs.hak5.org/shark-jack/)

## [Packet Squirrel](https://hak5.org/products/packet-squirrel)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fz6eAuL8leW3epHxLKJRl%2FScreenshot%20from%202023-02-01%2018-35-38.png?alt=media&amp;token=973b2a28-07ca-4e14-927f-927f21b6966f" alt=""><figcaption></figcaption></figure>

The Packet Squirrel supports DuckyScript 2.0 + bash scripting

[Packet Squirrel Documentation](https://docs.hak5.org/packet-squirrel/)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FhO6arXBlLRwn0qzsKGYc%2FScreenshot%20from%202023-02-01%2017-23-00.png?alt=media&amp;token=8be4b109-1fcb-4b62-a8e8-cd10b36d9477" alt=""><figcaption><p>Packet Squirrel Mode</p></figcaption></figure>

### Squirrel Payload Deployment

Click ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F471UdUTDDi4AGUANtx3B%2FScreenshot%20from%202023-02-01%2018-28-32.png?alt=media\&token=33482fcd-c961-499b-b0cd-2ebee1eebad4) or ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FvNmHR3T1d6fAcXVlqOGg%2FScreenshot%20from%202023-02-01%2018-38-06.png?alt=media\&token=d7f300fd-6f23-4f55-a403-37f50248f53d)

Next, arm and transfer to the device - for more info see [Packet Squirrel Documentation](https://docs.hak5.org/packet-squirrel/)

## [LAN Turtle](https://hak5.org/products/lan-turtle)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FEsU4WHGZM4RMewk3cfJC%2FScreenshot%20from%202023-02-01%2018-35-43.png?alt=media&amp;token=534d18ea-1a07-436d-9119-53de688cb294" alt=""><figcaption></figcaption></figure>

The LAN Turtle supports DuckyScript 2.0 + bash scripting

[LAN Turtle Documentation](https://docs.hak5.org/lan-turtle/)

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FBlZKwah4sjsDLLUB7KN1%2FScreenshot%20from%202023-02-01%2017-23-12.png?alt=media&amp;token=5d95555e-7fb0-46d0-91f7-433fe2de0d0e" alt=""><figcaption><p>LAN Turtle Mode</p></figcaption></figure>

### Turtle Payload Deployment

Click ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F471UdUTDDi4AGUANtx3B%2FScreenshot%20from%202023-02-01%2018-28-32.png?alt=media\&token=33482fcd-c961-499b-b0cd-2ebee1eebad4) or ![](https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F7ddsdwA1Clgy6cXgB5MR%2FScreenshot%20from%202023-02-01%2018-38-06.png?alt=media\&token=f735aa45-fed6-4a8f-82f0-05556e59197e)

Next, arm and transfer to the device - for more info see [LAN Turtle Documentation](https://docs.hak5.org/lan-turtle/)
