DuckLogger

ducklogger

DuckLogger एक ESP32-S3-आधारित USB Key Logger है। यह कीस्ट्रोक को एक टेक्स्ट फ़ाइल में लॉग करता है, और बिल्ट-इन वाई-फ़ाई एक्सेस पॉइंट के माध्यम से लॉग्स डाउनलोड करने के लिए वायरलेस एक्सेस प्रदान करता है। इस प्रोजेक्ट को फिर से बनाने के लिए किसी कस्टम PCB की आवश्यकता नहीं है। यहाँ उपयोग किया गया हार्डवेयर कुल मिलाकर अलीएक्सप्रेस जैसी जगहों पर $10 से भी कम है।

broader view

विशेषताएँ

कीस्ट्रोक लॉगिंग: कीस्ट्रोक को रिकॉर्ड करता है और उन्हें आंतरिक फ्लैश स्टोरेज में एक लॉग फ़ाइल में सहेजता है।
दोहरी वाई-फ़ाई मोड: वाई-फ़ाई स्टेशन मोड (किसी मौजूदा नेटवर्क से कनेक्ट) और एक्सेस पॉइंट (हॉटस्पॉट) मोड दोनों का समर्थन करता है।
वेब कमांड और कंट्रोल सेंटर: अपने डिवाइस को प्रबंधित करने के लिए एक बिल्ट-इन वेब इंटरफ़ेस तक पहुँचें। नियंत्रण केंद्र आपको निम्नलिखित की अनुमति देता है:
- लॉग्स डाउनलोड करें: सहेजी गई कीस्ट्रोक लॉग फ़ाइल को आसानी से डाउनलोड करें।
- रिमोट लाइव कीबोर्ड: एक लाइव वर्चुअल कीबोर्ड अटैच करें और लगभग बिना विलंबता के वेबसॉकेट के माध्यम से वास्तविक समय में कीस्ट्रोक भेजें।
- DuckyScript इंजेक्शन: DuckyScript पेलोड को दूरस्थ रूप से इंजेक्ट और निष्पादित करें।
- डिवाइस सेटिंग्स: वेब UI से सीधे AP/स्टेशन मोड के लिए कॉन्फ़िगरेशन अपडेट करें।

वेब UI तक पहुँचें:

http://192.168.4.1/

(जब एक्सेस पॉइंट मोड में हो)

web command and control center of ducklogger

उपयोग किए गए घटक

ESP32-S3 SuperMini
CH9350 HID मॉड्यूल
4 फीमेल जम्पर वायर्स

शुरुआत

1. स्कीमैटिक्स

wiring schematics

ESP32-S3	CH9350
5V	5V
GND	GND
GP1	TX
GP2	RX

CH9350 कई ऑपरेटिंग मोड्स का समर्थन करता है, जो ऑनबोर्ड DIP स्विच का उपयोग करके कॉन्फ़िगर किए जाते हैं।

CH9350 dip switch config for host mode

S0 को GND स्थिति (0) पर सेट करें और अन्य सभी स्विच को विपरीत स्थिति (1) पर रखें। यह USB होस्ट मोड को सक्षम करता है, जो USB कीबोर्ड इनपुट को सीरियल डेटा में परिवर्तित करता है जो डिफ़ॉल्ट बॉड दर 115200 पर UART के माध्यम से भेजा जाता है।

2. MicroPython फ्लैश करें

DuckLogger MicroPython में लिखा गया है। अपने बोर्ड को MicroPython फर्मवेयर से फ्लैश करें। फ्लैशिंग निर्देश यहाँ पाएँ।

फ्लैश करने के बाद, बोर्ड को USB से डिस्कनेक्ट करें और पुनः कनेक्ट करें।

3. रिपॉजिटरी क्लोन करें

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

4. बोर्ड पर DuckLogger इंस्टॉल करें

सुनिश्चित करें कि आपका बोर्ड USB से जुड़ा है, फिर चलाएँ:

python flasher.py

फ़्लैशर स्वचालित रूप से:

बोर्ड पर mpremote और आवश्यक MicroPython पैकेज इंस्टॉल करेगा
index.html को संपीड़ित करेगा और सभी फ़ाइलों को बोर्ड पर कॉपी करेगा
बोर्ड को रीबूट करेगा

उपयोग

USB कीबोर्ड को CH9350 HID मॉड्यूल में प्लग करें।
ESP32-S3 SuperMini को USB-C से USB-A केबल का उपयोग करके लक्ष्य PC से कनेक्ट करें।
डिवाइस स्वचालित रूप से:
- कीस्ट्रोक लॉग करना शुरू करेगा
- आपकी सेटिंग्स के अनुसार वाई-फ़ाई से कनेक्ट होगा या वाई-फ़ाई एक्सेस पॉइंट बनाएगा
- HTTP सर्वर शुरू करेगा

यदि एक्सेस पॉइंट मोड (डिफ़ॉल्ट) में है, तो वाई-फ़ाई एक्सेस पॉइंट से कनेक्ट करें (डिफ़ॉल्ट पासवर्ड: duckPass1234) और खोलें:

http://192.168.4.1/

कमांड और कंट्रोल सेंटर तक पहुँचने के लिए।

समर्थित DuckyScript सिंटैक्स

DuckLogger वर्तमान में पेलोड इंजेक्शन के लिए DuckyScript कमांड के एक मूल सेट का समर्थन करता है:

रिपॉजिटरी संरचना

.
├── 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

तृतीय-पक्ष पुस्तकालय

इस प्रोजेक्ट में मिगुएल ग्रिनबर्ग (MIT लाइसेंस) द्वारा Microdot शामिल है:
https://github.com/miguelgrinberg/microdot

`DELAY`	निष्पादन को निर्दिष्ट मिलीसेकंड के लिए रोकता है।	`DELAY 500`
`STRING`	वर्णों के अनुक्रम को बिल्कुल लिखे अनुसार टाइप करता है।	`STRING Hello, World!`
Key Combos	एक साथ कीस्ट्रोक भेजता है।	`CTRL SHIFT ESC` या `ALT i`
Single Keys	व्यक्तिगत विशेष कुंजियाँ भेजता है।	`ENTER` या `TAB`

सबसे लोकप्रिय

duckLogger