BadCard

BadUSB View the repo

BadCard is a BadUSB firmware for the Cardputer that processes and executes Ducky Script payloads. It adds Bluetooth connectivity, on‑device file editing, folder navigation, and support for many keyboard layouts.

auto-summary

148 stars · 18 forks

Maintainer
voidnoi
Capabilities
badusbble
Chip families
esp32-s3

Runs on these boards

Unverified

  • CardputerUnverifiedM5Stack
    Flash Cardputerguided

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

README

BadCard

BadUSB for the Cardputer with ducky script support and extra functionality

Ducky Script processing and executing ported from arducky

FEATURES

  • Bluetooth connection
  • File editing (Thanks to @guidoaguiar)
  • Horizontal file navigation
  • Multiple Keyboard layouts (en_US, es_ES, de_DE, pt_PT, fr_FR, sv_SE, it_IT, hu_HU, da_DK, pt_BR, en_GB, nb_NO, ja_JP).
  • You can navigate, create and delete folders

You can contribute to BadCard by creating your own keyboard layouts following this guide: How to create a keyboard layout for BadCard

If you're having trouble executing your payloads on Windows 11 try adding a DELAY 500 at the end of your payload https://github.com/VoidNoi/BadCard/issues/1#issuecomment-2000571655

How to use

You can place your payloads inside the /BadCard folder on your SD card (It will be created automatically after installing BadCard)
Your files should use the .txt extension.

OR

You can make your own payloads in your cardputer with the "NEW FILE" option

Available commands 
 (1) Commands without payload:
 - ENTER
 - MENU <=> APP
 - DOWNARROW <=> DOWN
 - LEFTARROW <=> LEFT
 - RIGHTARROW <=> RIGHT
 - UPARROW <=> UP
 - BREAK <=> PAUSE
 - CAPSLOCK
 - DELETE
 - END
 - ESC <=> ESCAPE
 - HOME
 - INSERT
 - NUMLOCK
 - PAGEUP
 - PAGEDOWN
 - PRINTSCREEN
 - SCROLLLOCK
 - SPACE
 - TAB
 - REPLAY (global commands aren't implemented)
 
 (2) Commands with payload:
 - DEFAULT_DELAY <=> DEFAULTDELAY (global commands aren't implemented.)
 - DELAY (+int)
 - STRING (+string)
 - GUI <=> WINDOWS (+char)
 - SHIFT (+char or key)
 - ALT (+char or key)
 - CTRL <=> CONTROL (+char or key)
 - REM (+string)

File creating/editing controls

  • You can navigate your file pressing fn and the up, down, left or right keys (aka ;, ., , or /)
  • When you're finished creating your file press fn and esc, add the name of your file and press enter (you don't need to add the .txt extension)
  • Delete folders by pressing the G0 button and enter for the selected folder

About BLE

  • Doesn't support special keys (ñ, ß, etc) like USB does
  • It may skip some characters, especially characters that require modifier keys (SHIFT, ALTGR)

Read the full README on GitHub

source github.com/VoidNoi/BadCard