Getting Started

Understanding the basics of the PayloadStudio interface

TL;DR Overview

Upon logging in for the first time PayloadStudio will take you on a tour; you can relaunch the tour under Help > Product Tour at any time for a refresher!

Access various features and settings of PayloadStudio. Clicking one will toggle the menu open/closed.

File Menu

Import or Open Payloads

Don't know where to start on your payload writing journey? Open Examples, import via URL or even upload from local files directly into the editor!

Resources

Links directly to relevant repositories, Hak5 PayloadHub, Shop and Community.

Payload Editor

Here you can craft your payloads for all your favorite Hak5 gear. We've got it all set up for you with everything from autocompletion to syntax highlighting and more. Where you'll spend most of your time in PayloadStudio!

Remember: you can customize your experience in the Settings!

Compile / Deploy

Compile your DuckyScript payloads, or, for other device modes, save your payload.

Read More about devices and deploying payloads

Console

PayloadStudio will use this as a location to tell you important info. It's also used for DuckyScript Debugging/Breakpoints. Errors, messages, and status updates will appear here. Hide the console to keep it out of the way while building your payload or open it for an easy notepad-like environment to test your keystroke injection in! No more juggling multiple windows!

The console can be used to test parts of your payload, it's also a convenient text editor with the ability to Edit, Save, Clear, and toggle Open with ease.

Open the Console

Minimize the console

ESC / Escape will also minimize the console if it is open in the default keybinding mode

Help menu

Here you can find links to more detailed documentation (here 👋) as well as other useful info

Session Status bar

The session status bar provides at a glance info regarding your payload editing session as well as shortcuts to common actions.

Info, warning and error counts

Info, warning and error counts are only used in USB Rubber Ducky mode

Clicking one of the Info, warning and error indicators will step through them in your editor

Current DUCKY_LANG

DUCKY_LANG is only used in USB Rubber Ducky mode

Clicking the language by default will bring you to Compiler Settings to change your DUCKY_LANG

Editing / Read Only mode indicator and toggle

Toggle editor from Read Only to Editing by clicking the label or icon pinned to the top right above the editor

Session Save Status

Change Editor Modes by clicking the device name or logo, and view + edit your current payload filename

Payload Name

Ready to export your payload source code? Naming it will help keep you organized. Change the name of your payload by double clicking the current payload name from the top left of the editor.

Device / Editing mode

Changing editor modes is as easy as two clicks!

  1. Click the current device from the top left of the editor

  2. Choose a new device mode from the Device Picker Menu

Read More about devices and deploying payloads

Last updated