[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80564":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":14,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":14,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},80564,"esp32-c5-deauth","maxbrito500\u002Fesp32-c5-deauth","maxbrito500","A deauth with nuker for 2.4Ghz and 5Ghz controlled by BLE with Android app",null,"C",65,8,61,3,0,1,4,46.76,"Other",false,"main",true,[],"2026-06-12 04:01:29","# 5G Deauther — Dual-Band Wi-Fi Deauthentication Toolkit\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"screenshots\u002Fpanel1-deauth-wifi-routers.png\" alt=\"Flutter controller showing the scanned network list\" width=\"380\">\n\u003C\u002Fp>\n\nESP32-C5 firmware that scans 2.4 GHz and 5 GHz access points and lets a\ncontroller (mobile, desktop, or watch) send 802.11 deauthentication frames\nto selected targets over a Bluetooth LE link. Three controller front-ends\nare included in this repo:\n\n| Front-end | Path | Notes |\n|-----------|------|-------|\n| ESP32-C5 firmware | `esp32-c5\u002F` | The radio. ESP-IDF project for the Seeed XIAO ESP32-C5. |\n| Flutter app | `flutter\u002F` | Android \u002F Linux desktop. Full-featured (whitelist, blacklist, nuke, console). |\n| Garmin watch app | `garmin\u002F` | Connect IQ app for the Fenix 7 series. Minimal: scan → list networks → deauth. |\n\nThe radio and the controllers speak the Nordic UART Service (NUS) BLE\nprofile with a simple line-buffered text protocol. See\n`esp32-c5\u002FREADME.md` for the protocol reference.\n\n## Screenshots & demos\n\n| Networks panel | Nuke demo |\n|----------------|-----------|\n| \u003Cimg src=\"screenshots\u002Fpanel1-deauth-wifi-routers.png\" alt=\"Networks tab\" width=\"320\"> | \u003Cimg src=\"screenshots\u002Fpanel2-nuke-all-routers.gif\" alt=\"Nuke radar in action\" width=\"320\"> |\n\nThe Networks panel sorts scanned APs by band and signal, and lets you\ntick individual targets before pressing **Deauth**. The Nuke tab clip\nshows the radar view that drives every visible AP simultaneously for a\nchosen duration.\n\n---\n\n## ⚠️  Ethical use only\n\nThis project is published for **defensive security research and\neducation** — penetration testing on networks you own or have explicit\nwritten permission to assess, security training, capture-the-flag\nexercises, lab demonstrations of Wi-Fi protocol weaknesses, and academic\nstudy.\n\nUsing deauthentication frames against networks you do not own or do not\nhave explicit permission to test is **illegal in most jurisdictions**.\nExamples that are NOT covered by this license:\n\n- Interfering with a neighbor's, employer's, café's, school's, or\n  airport's Wi-Fi\n- Disrupting other people's video calls, smart-home devices, or IoT\n  equipment\n- Mass denial-of-service against arbitrary access points\n- Bypassing captive portals or evading paid Wi-Fi access controls\n\nIf you would not be comfortable showing the network owner exactly what\nyou are doing, **do not run this firmware against that network**.\n\nYou are solely responsible for your use of this software. By building,\nflashing, or running it you accept that responsibility.\n\n---\n\n## Quick flash (browser, no install)\n\nThe fastest way to get the firmware onto an ESP32-C5: plug the board in\nover USB-C and click this link in **Chrome or Edge** (Web Serial is\nrequired, so Firefox\u002FSafari won't work).\n\n[**Flash ESP32-C5 Deauther in your browser →**](https:\u002F\u002Fespressif.github.io\u002Fesp-launchpad\u002F?flashConfigURL=https:\u002F\u002Fraw.githubusercontent.com\u002Fmaxbrito500\u002Fesp32-c5-deauth\u002Fflasher\u002Fconfig.toml)\n\nThe page is Espressif's official **ESP Launchpad** with a preset that\npoints at the firmware in this repo. Hit *Connect*, pick the serial\nport for the XIAO, then *Flash* — the merged binary is written at\noffset `0x0000`, no manual address juggling. Total time: under a minute.\n\nWhen the device is running, install the Android APK or Linux desktop\napp below to control it over BLE.\n\n---\n\n## Downloads\n\nPre-built binaries are published on the\n[**Releases**](https:\u002F\u002Fgithub.com\u002Fmaxbrito500\u002Fesp32-c5-deauth\u002Freleases)\npage for every tagged version. No toolchain required:\n\n| File | Use it for |\n|------|-----------|\n| `esp32c5-deauther-firmware.zip` | ESP32-C5 firmware bundle. Prefer the [browser flasher above](#quick-flash-browser-no-install); the zip is for offline \u002F `esptool` users. |\n| `deauther-android.apk` | Android phones — single APK that runs on all CPU architectures (arm64, armv7, x86_64). |\n| `deauther-linux-x64.tar.gz` | Linux desktop. Extract and run `.\u002Fdeauther`. |\n| `SHA256SUMS` | Checksums to verify the downloads |\n\nThe Garmin watch app is not currently in the release bundle — it has to\nbe built locally because Connect IQ apps are signed with a per-developer\nkey (see `garmin\u002Frun-fenix7pro.sh`).\n\n---\n\n## Hardware\n\n- **Seeed Studio XIAO ESP32-C5** — see `specs.md`. Other ESP32-C5 boards\n  should work; only the on-board LED GPIO would need adjustment in\n  `esp32-c5\u002Fmain\u002Fled.c`.\n- USB-C cable (data, not charge-only) for flashing.\n- (Optional) Garmin Fenix 7 family watch.\n\n## Build from source (Ubuntu 22.04 \u002F 24.04)\n\nTested on a clean Ubuntu install. Each component can be built\nindependently — install only the toolchain you need.\n\n### ESP32-C5 firmware\n\n```sh\n# 1. System packages required by ESP-IDF.\nsudo apt-get update\nsudo apt-get install -y \\\n    git wget flex bison gperf python3 python3-venv python3-pip \\\n    cmake ninja-build ccache dfu-util libusb-1.0-0 \\\n    libffi-dev libssl-dev\n\n# 2. Clone ESP-IDF v5.5.1 (matches the patched libnet80211.a).\nmkdir -p ~\u002Fesp && cd ~\u002Fesp\ngit clone -b v5.5.1 --recursive https:\u002F\u002Fgithub.com\u002Fespressif\u002Fesp-idf.git\ncd esp-idf\n.\u002Finstall.sh esp32c5            # downloads RISC-V toolchain + tools\n\n# 3. Activate the toolchain in your current shell.\n. ~\u002Fesp\u002Fesp-idf\u002Fexport.sh        # add this to ~\u002F.bashrc to make it permanent\n\n# 4. Apply the wifi patch and build.\ncd \u002Fpath\u002Fto\u002Fthis\u002Frepo\u002Fesp32-c5\ncp patched_libnet\u002Flibnet80211.a \"$IDF_PATH\u002Fcomponents\u002Fesp_wifi\u002Flib\u002Fesp32c5\u002F\"\nidf.py set-target esp32c5\nidf.py build\n\n# 5. Flash via USB-C JTAG (no BOOT\u002FRESET button presses needed).\n.\u002Fflash.sh\n```\n\nThe patched `libnet80211.a` makes `esp_wifi_80211_tx()` accept\nmanagement frames with a spoofed source address — required for\ndeauthentication on the C5's 5 GHz radio. The original library is kept\nas `libnet80211.a.orig` after the first patch.\n\n### Flutter — Android APK\n\n```sh\n# 1. JDK 17.\nsudo apt-get install -y openjdk-17-jdk\n\n# 2. Flutter SDK (stable channel).\ngit clone -b stable --depth 1 https:\u002F\u002Fgithub.com\u002Fflutter\u002Fflutter.git ~\u002Fflutter\necho 'export PATH=\"$HOME\u002Fflutter\u002Fbin:$PATH\"' >> ~\u002F.bashrc\nexport PATH=\"$HOME\u002Fflutter\u002Fbin:$PATH\"\n\n# 3. Android command-line tools — point Flutter at your Android SDK\n#    (Android Studio installs this; otherwise grab \"command-line tools\n#    only\" from https:\u002F\u002Fdeveloper.android.com\u002Fstudio and unzip into\n#    ~\u002FAndroid\u002FSdk\u002Fcmdline-tools\u002Flatest\u002F, then accept licenses).\nflutter doctor --android-licenses\nflutter doctor                      # should be all green for Android\n\n# 4. Build a universal APK that runs on every CPU architecture.\ncd \u002Fpath\u002Fto\u002Fthis\u002Frepo\u002Fflutter\nflutter pub get\nflutter build apk --release\nls build\u002Fapp\u002Foutputs\u002Fflutter-apk\u002Fapp-release.apk\n```\n\nInstall on a phone with `adb install` (USB debugging enabled) or by\ncopying the `.apk` to the phone and tapping it.\n\n### Flutter — Linux desktop\n\n```sh\n# 1. GTK and build tools.\nsudo apt-get install -y \\\n    clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev \\\n    libsecret-1-dev libjsoncpp-dev\n\n# 2. Flutter SDK (same as above).\nflutter config --enable-linux-desktop\n\n# 3. Build and run.\ncd \u002Fpath\u002Fto\u002Fthis\u002Frepo\u002Fflutter\nflutter pub get\nflutter run -d linux                 # or: flutter build linux --release\n```\n\n### Garmin watch app\n\nThe Garmin SDK requires a (free) developer account — see\n[`garmin\u002F`](garmin\u002F) for the build scripts (`run-fenix7pro.sh`,\n`sideload.sh`).\n\n---\n\n## On-device LED indicator\n\nThe yellow user LED on the XIAO ESP32-C5 (GPIO 27, active-low) signals\nstate via blink rhythm — single-color hardware doesn't allow color\ncoding:\n\n| State | Pattern |\n|-------|---------|\n| Idle (no BLE client) | one short flash every 5 seconds |\n| BLE client connected | two short flashes every 5 seconds |\n| Attack running | continuous rapid strobe (~6 Hz) |\n\nThe separate red **C** LED on the board lights up only when the device\nis running on battery — that's a hardware indicator, not controlled by\nthe firmware.\n\n---\n\n## Repository layout\n\n```\n.\n├── esp32-c5\u002F        # ESP-IDF firmware (NimBLE + dual-band scanner + deauth engine)\n├── flutter\u002F         # Cross-platform controller app (BLE + HTTP API)\n├── garmin\u002F          # Connect IQ watch app (Monkey C)\n├── inspirations\u002F    # Reference implementations from related projects\n├── specs.md         # XIAO ESP32-C5 hardware reference\n├── LICENSE          # Apache 2.0\n└── NOTICE           # Third-party attributions\n```\n\n---\n\n## Credits\n\nThis project began as a re-architecture of\n[**AnvilBrain\u002Fesp32-c5-dualband-deauther**](https:\u002F\u002Fgithub.com\u002FAnvilBrain\u002Fesp32-c5-dualband-deauther),\nwhich proved that the ESP32-C5's 5 GHz radio could be coerced into sending\nspoofed-SA management frames. Thanks to AnvilBrain for publishing that\nwork and the libnet80211.a patch that makes 5 GHz deauth possible on\nthis chip. The original project is MIT-licensed.\n\nThis repo is licensed under **Apache 2.0** (see [`LICENSE`](LICENSE) and\n[`NOTICE`](NOTICE)).\n","该项目是一个双频Wi-Fi去认证工具包，支持2.4GHz和5GHz频段，并通过蓝牙低功耗（BLE）由Android应用控制。其核心功能包括扫描周围接入点并发送802.11去认证帧以断开指定目标的连接，同时提供了白名单、黑名单及一键清除所有网络等高级特性。技术上基于C语言开发，使用ESP-IDF框架适配Seeed XIAO ESP32-C5开发板，并通过Nordic UART Service BLE协议与控制器通信。适用于网络安全研究、教育演示以及合法授权下的渗透测试场景中评估Wi-Fi网络的安全性。",2,"2026-06-11 04:01:15","CREATED_QUERY"]