DuckLogger

DuckLogger es un registrador de teclas USB basado en ESP32-S3. Registra las pulsaciones de teclas en un archivo de texto y proporciona acceso inalámbrico para descargar los registros a través de un punto de acceso Wi-Fi integrado. Recrear este proyecto no requiere ninguna PCB personalizada. El hardware utilizado aquí cuesta menos de $10 en total en lugares como Aliexpress.

Características

• Registro de pulsaciones: Graba las pulsaciones de teclas y las guarda en un archivo de registro en la memoria flash interna.
• Modos Wi-Fi duales: Soporta tanto el modo Estación Wi-Fi (conectarse a una red existente) como el modo Punto de Acceso (Hotspot).
• Centro de Comando y Control Web: Accede a una interfaz web integrada para gestionar tu dispositivo. El centro de control te permite:
  • Descargar registros: Descarga fácilmente el archivo de registro de pulsaciones guardado.
  • Teclado en vivo remoto: Adjunta un teclado virtual en vivo y envía pulsaciones a través de WebSocket en tiempo real con casi cero latencia.
  • Inyección DuckyScript: Inyecta y ejecuta payloads de DuckyScript de forma remota.
  • Configuración del dispositivo: Actualiza las configuraciones del modo AP/Estación directamente desde la interfaz web.

Accede a la interfaz web en:

http://192.168.4.1/

(Cuando esté en modo Punto de Acceso)

Componentes Utilizados

• ESP32-S3 SuperMini
• CH9350 HID Module
• 4 Female Jumper Wires

Primeros Pasos

1. Esquemáticos

El CH9350 soporta múltiples modos de operación, los cuales se configuran mediante los interruptores DIP integrados.

Coloca S0 en la posición GND (0) y mantén todos los demás interruptores en la posición opuesta (1). Esto habilita el modo Host USB, que convierte las entradas del teclado USB en datos seriales enviados a través de UART a una velocidad de baudios predeterminada de 115200.

2. Flashear MicroPython

DuckLogger está escrito en MicroPython. Flashea tu placa con el firmware de MicroPython. Encuentra instrucciones de flasheo aquí.

Después de flashear, desconecta y vuelve a conectar la placa por USB.

3. Clonar el Repositorio

git clone https://github.com/Itsmmdoha/duckLogger.git
cd duckLogger

4. Instalar DuckLogger en la Placa

Asegúrate de que tu placa esté conectada por USB, luego ejecuta:

python flasher.py

El flasher automáticamente:

• Instalará mpremote y los paquetes de MicroPython necesarios en la placa
• Comprimirá index.html y copiará todos los archivos a la placa
• Reiniciará la placa

Uso

1. Conecta el teclado USB al módulo HID CH9350.

2. Conecta el ESP32-S3 SuperMini a la PC objetivo usando un cable USB-C a USB-A.

3. El dispositivo automáticamente:

   • Comenzará a registrar las pulsaciones
   • Se conectará a Wi-Fi o creará un punto de acceso Wi-Fi según tu configuración
   • Iniciará un servidor HTTP

Si está en modo Punto de Acceso (predeterminado), conéctate al punto de acceso Wi-Fi (Contraseña predeterminada: duckPass1234) y abre:

http://192.168.4.1/

Para acceder al centro de comando y control.

Sintaxis de DuckyScript Compatible

Actualmente DuckLogger soporta un conjunto básico de comandos DuckyScript para inyección de payloads:

Estructura del Repositorio

.
├── flasher.py
├── index.html
├── lib
│   ├── access_point.py
│   ├── api.py
│   ├── duckyscript.py
│   ├── keyboard.py
│   ├── key_led.py
│   ├── logger.py
│   ├── mapper.py
│   ├── microdot
│   │   ├── helpers.py
│   │   ├── __init__.py
│   │   ├── microdot.py
│   │   └── websocket.py
│   ├── queue.py
│   ├── settings.py
│   ├── uart_buffer.py
│   ├── wifi.py
│   └── wifi_radio.py
├── LICENSE
├── main.py
├── README.md
├── resources.md
└── settings.json

Bibliotecas de Terceros

Este proyecto incluye Microdot de Miguel Grinberg (Licencia MIT):
https://github.com/miguelgrinberg/microdot