This repository contains the official payload library for Lichee-Jack — a low-cost, open-source LAN attack & penetration testing device.
The payloads here are designed to be plug-and-play, easy to customize, and tightly integrated with the Lichee-Jack runtime, hardware, and LED status system.
A payload is a self-contained script that executes automatically when Lichee-Jack is armed and connected to a target system or network.
Payloads typically:
- Wait for hardware or network readiness
- Perform a specific task (recon, capture, demo, etc.)
- Store results in the loot directory
- Indicate status using onboard LEDs
Lichee-Jack-payloads/
├── basic/ # Basic examples and hardware tests
├── recon/ # Network reconnaissance payloads
├── misc/ # Experimental, demo, or non-offensive payloads
└── README.md
-
basic/ Introductory payloads and simple building blocks (audio, LED, helpers).
-
recon/ Network discovery and enumeration payloads (e.g. Nmap-based scans).
-
misc/ Non-core, experimental, or fun payloads used for demos or testing.
Most payloads follow these conventions:
-
Entry file named
payload.sh -
Written in POSIX shell / Bash
-
Uses helper commands provided by Lichee-Jack:
LEDNETMODEAUDIOCTL- ...
-
Stores output under:
/root/loot.d/
LED colors and patterns are commonly used to indicate state:
- Waiting / setup
- Running
- Finished / error
- Copy or select a payload directory
- Customize variables if needed (targets, options, credentials)
- Deploy the payload to the Lichee-Jack device
- Arm the device and connect it to the target
Refer to the main Lichee-Jack documentation for payload selection and execution details.
These payloads are provided for educational purposes and authorized security testing only.
You must have explicit permission to test, scan, or collect data from any system or network. The authors are not responsible for misuse.
Feel free to add more payloads or improve docs. Keep payloads small and well documented.
KaliAssistant — [email protected]
Lichee-Jack main Repository: https://github.com/KaliAssistant/Lichee-Jack.git
Lichee-Jack-utils Repository: https://github.com/KaliAssistant/Lichee-Jack-utils.git
GPLv3
This repository is part of the Lichee-Jack open-source project by KaliAssistant. Inspired by hacker gadgets such as the Hak5 Shark Jack, but fully original and open.