Repository navigation
Installation
Which path do I follow?
- M5Stack CardputerZero → use the App Store (one-tap) just below. No flashing, no terminal.
- Raspberry Pi (Zero 2 W / 3B+ / 4B) → follow Part 1 onward for the manual install.
If you have a M5Stack CardputerZero, RaspyJack is published on the official CardputerZero App Store and installs in one tap. Nothing to flash, no SSH, no git.
- Power on the CardputerZero and connect it to Wi-Fi.
- Open the App Store from the launcher.
- Search for RaspyJack (or enter the share code
RJAK), then tap Install. - Wait for the install to finish, then launch RaspyJack from the apps list.
The store build ships the full toolkit and runs its own first-boot provisioning (extra packages, drivers) with an on-screen progress feed, so the first launch after install takes a few minutes before the menu appears. Updates are delivered through the store too: when a new version is published, the App Store offers the upgrade.
This is a known CardputerZero issue, and it is a sudo-permission difference between factory images, not a bug in the app.
RaspyJack needs root, so the launcher starts it with sudo. Some CardputerZero factory images do not grant the first user passwordless sudo. At boot, sudo then asks for a password that nobody can type, the app exits immediately, and APPLaunch drops straight back to the menu (the screen may freeze for a couple of seconds first). It works right after install, or when you launch it once over SSH, because sudo is still authenticated from that session, but it does not survive a reboot.
How to tell it is this: over SSH, sudo -l returns nothing (no NOPASSWD), and the launcher journal shows sudo: a password is required right after launching run-raspyjack.sh.
Fix (run once over SSH, no reboot needed). Grant passwordless sudo to the device group RaspyJack runs as. %gpio covers the launching user whatever its name is (pi, or a custom one set in the imager / first-boot wizard):
echo '%gpio ALL=(ALL) NOPASSWD: ALL' | sudo tee /etc/sudoers.d/010-raspyjack
sudo chmod 0440 /etc/sudoers.d/010-raspyjack
sudo visudo -c # must report "parsed OK" for every file; if it errors, delete the file above before rebootingLaunch RaspyJack from the icon again: it now starts every time, including after a reboot. A permanent fix that removes this manual step is coming in a store update.
The App Store is the easy path, but you can still install from scratch on the CardputerZero if you want (for example to run the latest git HEAD instead of the published release, or for development). The device already ships with Debian, so skip Part 1 (no OS flashing needed) and go straight to Part 2: Install RaspyJack. Open a terminal on the device or connect over SSH, then run the same git clone + install_raspyjack.sh steps as on a Raspberry Pi.
The App Store path is CardputerZero only. On a Raspberry Pi, use the manual install below.
These steps are copied from the original README, with the same images.
Install Raspberry Pi Imager
Select Raspberry Pi Zero 2 W
Go in Raspberry Pi OS (other)
Select Raspberry Pi OS Lite (32-bit)
Select your SD card
Change settings to configure user and enable SSH


Set username and password and enable SSH
You can now connect via SSH:
ssh raspyjack@<IP>Run as root (RaspyJack expects /root/Raspyjack).
sudo apt install git
sudo su
cd /root
git clone https://github.com/7h30th3r0n3/raspyjack.git
mv raspyjack Raspyjack
cd Raspyjack
chmod +x install_raspyjack.sh
sudo ./install_raspyjack.sh
sudo rebootThe installer will ask which LCD screen you have:
- 1) ST7735_128 — Waveshare 1.44" 128x128 (original)
- 2) ST7789_240 — Waveshare 1.3" 240x240
You can change the screen type later from the LCD menu: Payload → Utilities → display_selector
Note: depending on how the repo is downloaded, the folder name can differ. Make sure the directory is /root/Raspyjack.
sudo su
cd /root
rm -rf Raspyjack
git clone https://github.com/7h30th3r0n3/raspyjack.git
mv raspyjack Raspyjack
sudo rebootWiFi attacks require a USB WiFi dongle (monitor mode).
- Plug in USB WiFi dongle (see hardware requirements).
- Run WiFi Manager from the RaspyJack menu.
- Configure WiFi profiles for auto-connect.
- Test interface switching between wlan0/wlan1.
- Run deauth attacks on target networks.
Quick test:
cd /root/Raspyjack/payloads
python3 fast_wifi_switcher.pyRaspyJack is for educational and authorized testing only. Use responsibly.
RaspyJack Wiki
Getting Started
Using RaspyJack
Payloads
Built-in Tools
Utilities
Reference
Radio & SDR
NFC & RFID
WebUI
Hardware