wifit3

# wifit3
> Linux, Windows और macOS के लिए एक स्टैंडअलोन USB Wi-Fi ऑडिटर।

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/50012/04606166e4819097d373eac8e473da43c3c80449f1e3c4ed8b2652ada7a80d96.png" alt="wifit3 स्प्लैश / एडाप्टर पिकर" width="700">
</p>

> [समर्थित USB एडाप्टर](#supported-hardware) में से **कम से कम** एक **आवश्यक** है।

## क्यों?
* **क्रॉस-प्लेटफ़ॉर्म:** Linux, macOS और Windows पर समान रूप से चलता है।
* **वायरलेस ड्राइवर स्वर्ग:** अंतर्निहित वायरलेस स्टैक कर्नेल ड्राइवर वर्ज़निंग की समस्या और Windows के NDIS से बचाता है।
* **शून्य रनटाइम निर्भरताएँ:** कोई `aircrack-ng` या `reaver` नहीं, बस PyUSB और Textual लाइब्रेरीज़ के साथ शुद्ध Python।

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/50012/2efdf06fe93e90c9b114d815ee6a0f847a42f4259fba335ee71e94a3c6c88fa6.gif" alt="wifit3 काम करते हुए: WPS PushButton PSK कैप्चर" width="700">
</p>

---

## विशेषताएँ

### रेकॉनिसेंस और विश्लेषण
- **मल्टी-कार्ड एग्रीगेशन:** एक साथ कई एडाप्टरों पर पैकेट कैप्चर करें; इंजेक्ट करने के लिए एक समर्पित कार्ड चुनें।
- **रियल-टाइम स्कैनर:** 2.4GHz और 5GHz चैनल-हॉपिंग (मल्टी-कार्ड के लिए विभाजित); सिग्नल स्ट्रेंथ, एन्क्रिप्शन सूट, WPA3/SAE ट्रांज़िशन मोड ट्रैक करता है।
- **AP और क्लाइंट पहचान:** डिवाइस विक्रेताओं और श्रेणियों की फ़िंगरप्रिंटिंग करता है; WPS बीकन से राउटर का मेक और मॉडल निकालता है।
- **VAP डिक्लोकिंग:** छिपे हुए नेटवर्क की पहचान उनके BSSID को ज्ञात दृश्य सिबलिंग्स के साथ सहसंबंधित करके करता है।
- **पैकेट डैशबोर्ड:** रियल-टाइम बीकन, डेटा, इंजेक्शन और डीऑथेंटिकेशन पैकेट दरों का विज़ुअलाइज़ेशन करता है।

### हमले और कैप्चर
- **WPA/WPA2 हैंडशेक:** पैसिव स्निफ़िंग और लक्षित डीऑथेंटिकेशन; क्रैक करने योग्य जोड़ों को मान्य करता है; `.pcap` और `.hc22000` फ़ाइलें निर्यात करता है।
- **PMKID हार्वेस्टिंग:** WPA/WPA2 PMKID कुंजी सामग्री (`.hc22000`) के लिए सक्रिय एसोसिएशन हार्वेस्ट और पैसिव स्निफ़िंग।
- **EvilTwin WPA3 डाउनग्रेड:** AP को क्लोन करता है और हैंडशेक कैप्चर करने के लिए क्लाइंट्स को बाहर निकालता है (CSA, BTM और डी-ऑथ के माध्यम से)। सिंगल और मल्टीपल कार्ड पर काम करता है।
- **WPS रिकवरी सूट:**
  - **PixieDust (2 मोड):** *Null Secret* और *Static Secret* PRNG कमज़ोरियों का शोषण करते हुए तत्काल ऑफ़लाइन PIN रिकवरी।
  - **PushButton (PBC):** भौतिक WPS बटन प्रेस का पता लगाता है और तुरंत प्लेनटेक्स्ट WPA PSK निकालता है।
  - **PIN ब्रूट-फ़ोर्स:** ज्ञात-PIN डेटाबेस और AP लॉक मॉनिटरिंग के साथ फिर से शुरू करने योग्य WPS PIN क्रैकिंग।
- **WEP सूट:** शुद्ध Python ARP रीप्ले, ChopChop, Fake Authentication और PTW कुंजी रिकवरी।

## स्क्रीनशॉट

| स्कैनर | फ़ोकस (एकल लक्ष्य) |
|---|---|
| ![स्कैनर](https://assets.kitploit.com/production/public/readmes/50012/24709c5d2e682635dbc1f238f6235658c265012351095aff0e197c74abb30b1b.png) | ![फ़ोकस](https://assets.kitploit.com/production/public/readmes/50012/cd1d31407229a1c28724255310dbc246dff51dc521e84fd2404c1594caaecc5d.png) |

## समर्थित हार्डवेयर

> **महत्वपूर्ण:** *कम से कम एक समर्थित USB वायरलेस एडाप्टर आवश्यक है।*

| चिपसेट | बैंड | कार्ड (मेक + मॉडल) |
|---|---|---|
| Atheros AR9271 | 2.4 GHz | ALFA AWUS036**NHA**, TP-Link TL-WN722N V1 |
| MediaTek MT7601U | 2.4 GHz | सामान्य अनब्रांडेड "nano" डोंगल |
| MediaTek MT7610U | 2.4 / 5 GHz | ALFA AWUS036**ACHM**, Panda PAU0B |
| MediaTek MT7612U | 2.4 / 5 GHz | ALFA AWUS036**ACM** |
| MediaTek MT7921AU | 2.4 / 5 GHz | ALFA AWUS036**AXM[L]**, Panda PAU0F |
| MediaTek MT7925U | 2.4 / 5 GHz | Netgear A9000 |
| Realtek RTL8812AU | 2.4 / 5 GHz | ALFA AWUS036**ACH** |
| Realtek RTL8814AU | 2.4 / 5 GHz | ALFA AWUS1900, ASUS USB-AC68 |
| Realtek RTL8821AU | 2.4 / 5 GHz | ALFA AWUS036**ACS**, TP-Link Archer T2U Plus/Nano |
| Realtek RTL8821CU | 2.4 / 5 GHz | Auscoumer 600 Mbps, Mercusys MU6H |
| Realtek RTL8922AU | 2.4 / 5 GHz | ASUS USB-BE93 |
| Realtek RTL8822BU | 2.4 / 5 GHz | TP-Link T3U Plus, Archer T4U v3 / T4U+ |
| Realtek RTL8822CU | 2.4 / 5 GHz | D-Link AC13U |
| Realtek RTL8187L | 2.4 GHz | ALFA AWUS036**H** |
| Realtek RTL8188EUS | 2.4 GHz | TP-Link TL-WN722N v2/v3, Mercusys MW150US |
| Realtek RTL8192FU | 2.4 GHz | D-Link AN3U rev. A1 |
| Ralink RT2570 | 2.4 GHz | Buffalo Nintendo Wi-Fi USB Controller |
| Ralink RT3070 | 2.4 GHz | ALFA AWUS036**NH**, TP-Link TL-WN7200ND |
| Ralink RT5370 | 2.4 GHz | LOTEKOO 150 Mbps |
| Ralink RT5372 | 2.4 GHz | Panda PAU05/PAU06 |
| Ralink RT5572 | 2.4 / 5 GHz | Panda PAU09 N600 |

प्रत्येक डिवाइस की क्षमताओं और सीमाओं का विवरण: [समर्थित हार्डवेयर दस्तावेज़](https://github.com/derv82/wifit3/blob/master/docs/SUPPORTED-HARDWARE.md)।

## इंस्टॉलेशन और चलाना

### विकल्प 1: पहले से बने बाइनरी डाउनलोड करें (अनुशंसित)
[**Releases**](https://github.com/derv82/wifit3/releases/latest) से नवीनतम स्टैंडअलोन एक्ज़ीक्यूटेबल डाउनलोड करें:

* **Windows:** `wifit3-windows-x64.exe` डाउनलोड करें और चलाएँ।
* **Linux (गैर-sudo):** `chmod +x wifit3-linux-x64 && ./wifit3-linux-x64`
* **macOS:** (क्वारंटीन बायपास करें)
  ```bash
  xattr -d com.apple.quarantine wifit3-macos-universal2
  chmod +x wifit3-macos-universal2
  ./wifit3-macos-universal2
  ```

### विकल्प 2: स्रोत से चलाएँ
wifit3 Astral के [`uv`](https://docs.astral.sh/uv/) का उपयोग करता है। `sync` निर्भरताएँ सेट करता है:
```bash
uv sync
uv run wifit3
```

### विकल्प 3: अपना खुद का बाइनरी बनाएं
```bash
uv run pyinstaller wifit3.spec --noconfirm --clean
```
बाइनरी एक्जीक्यूटेबल `dist/` सबडायरेक्टरी में लिखा जाता है।

## वन-टाइम ड्राइवर सेटअप

wifit3 ऐप के भीतर हार्डवेयर कॉन्फ़िगरेशन को स्वचालित रूप से संभालता है, `START` बटन पर क्लिक करने के बाद:

- **Linux:** `/etc/modprobe.d/` में udev अनुमतियाँ और ब्लॉकलिस्ट लिखने के लिए `pkexec`/`sudo` के माध्यम से एक बार प्रॉम्प्ट करता है।
- **macOS:** किसी इंस्टॉलेशन की आवश्यकता नहीं; डिवाइस प्लग इन करें और प्राधिकरण डायलॉग में *Allow* चुनें।
- **Windows:** डिवाइस के लिए WinUSB इंस्टॉल करने के लिए UAC के माध्यम से एक बार प्रॉम्प्ट करता है।
- **VirtualBox:** प्लग इन करने से *पहले* अपने डिवाइस को VirtualBox के `USB Filters` में जोड़ें।

## अनइंस्टॉल करना
पहले से इंस्टॉल किए गए डिवाइस को अपने ऑपरेटिंग सिस्टम के Wi-Fi स्टैक में वापस लौटाएँ:

1. wifit3 स्प्लैश स्क्रीन पर कार्ड चुनें।
2. `Uninstall` बटन पर क्लिक करें और पुष्टि करें।
3. एलिवेशन प्रॉम्प्ट स्वीकार करें (Windows पर UAC या Linux पर `pkexec`)।
4. एडाप्टर को अनप्लग करें और फिर से प्लग करें।

Linux पर, यह wifit3 के `udev` और `modprobe` नियमों को हटा देता है।
Windows पर, यह WinUSB बाइंडिंग को अनइंस्टॉल करता है, और PnP डिवाइस रीस्कैन को ट्रिगर करता है (पुराना ड्राइवर फिर से अटैच हो जाता है)।

## *धन्यवाद, Linux!*

wifit3 केवल उन महान लोगों के कारण मौजूद है जिन्होंने इन Linux वायरलेस
ड्राइवरों को रिवर्स-इंजीनियर किया और बनाए रखा। यह आमतौर पर एक बिना श्रेय वाला काम है।

विशेष धन्यवाद:
- **Christian "kimo" B. ([@kimocoder](https://github.com/kimocoder))** जो **wifite2** और `aircrack-ng` के RTL8188EUS DKMS ड्राइवर को बनाए रखते हैं।
- [**Neur0sp1cy**](https://github.com/neur0sp1cy): घनिष्ठ मित्र और मेरे Linux और वायरलेस-हैकिंग प्रशिक्षुता के गुरु।
- **Nick Morrow** ([@morrownr](https://github.com/morrownr)), लेजेंड, out-of-tree Realtek USB
  DKMS ड्राइवरों को बनाए रखते हैं।

पूरी सूची **[CREDITS.md](https://github.com/derv82/wifit3/blob/master/docs/CREDITS.md)** में है।

## यह कैसे काम करता है: मिनी-ड्राइवर

wifit3 ऑपरेटिंग सिस्टम के नेटिव Wi-Fi स्टैक को पूरी तरह से बायपास करता है। यह Linux कर्नेल ड्राइवरों के हल्के Python पोर्ट ([src/wifit3/chips/\*](https://github.com/derv82/wifit3/tree/master/src/wifit3/chips)) के साथ आता है जो USB बल्क और कंट्रोल ट्रांसफर के माध्यम से वायरलेस डिवाइसों को सीधे नियंत्रित करते हैं।

चूँकि रजिस्टर-लेवल फ्रेम इंजेक्शन और मॉनिटर मोड पूरी तरह से यूज़र स्पेस में किए जाते हैं, Windows NDIS प्रतिबंध और Linux कर्नेल ड्राइवर लॉकिंग लागू नहीं होते।

आर्किटेक्चर विवरण, ड्राइवर पोर्टिंग कार्यप्रणाली, और USB ट्रेस रीप्ले टूलिंग के लिए, [Porting Documentation](https://github.com/derv82/wifit3/blob/master/docs/porting/METHODOLOGY.md) देखें।

## लाइसेंस और अस्वीकरण

**कोड:** [**GNU General Public License v2.0**](https://github.com/derv82/wifit3/blob/master/LICENSE) के अंतर्गत लाइसेंस प्राप्त (अपस्ट्रीम Linux ड्राइवरों से मेल खाता है)।

**फर्मवेयर:** एडाप्टरों पर लोड किए गए विक्रेता फर्मवेयर ब्लॉब्स उनके संबंधित निर्माताओं के लाइसेंस के अंतर्गत यथावत पुनर्वितरित किए जाते हैं (विवरण [FIRMWARE.md](https://github.com/derv82/wifit3/blob/master/docs/FIRMWARE.md) में)।

**⚠️ सूचना और अस्वीकरण:** केवल उन नेटवर्कों और उपकरणों पर उपयोग के लिए जिनके आप स्वामी हैं या जिनका ऑडिट करने के लिए आपको स्पष्ट रूप से अधिकृत किया गया है। wifit3 कर्नेल गार्डरेल्स के बिना सीधे USB हार्डवेयर रजिस्टरों पर काम करता है; अपने जोखिम पर उपयोग करें।