{"id":49226670,"url":"https://github.com/nsm-barii/framework","last_synced_at":"2026-04-24T08:05:04.429Z","repository":{"id":329385568,"uuid":"1117766648","full_name":"NSM-Barii/framework","owner":"NSM-Barii","description":"IoT Explotation Framework","archived":false,"fork":false,"pushed_at":"2026-04-13T22:22:43.000Z","size":6200,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T00:29:06.037Z","etag":null,"topics":["ble","bluetooth","iot","mobile","uart","wifi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NSM-Barii.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-16T19:30:55.000Z","updated_at":"2026-04-13T22:22:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"070e25bc-11de-4742-82b2-83628a37f1f0","html_url":"https://github.com/NSM-Barii/framework","commit_stats":null,"previous_names":["nsm-barii/ble"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NSM-Barii/framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSM-Barii%2Fframework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSM-Barii%2Fframework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSM-Barii%2Fframework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSM-Barii%2Fframework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NSM-Barii","download_url":"https://codeload.github.com/NSM-Barii/framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSM-Barii%2Fframework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32214420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T03:15:14.334Z","status":"ssl_error","status_checked_at":"2026-04-24T03:15:11.608Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ble","bluetooth","iot","mobile","uart","wifi"],"created_at":"2026-04-24T08:05:01.781Z","updated_at":"2026-04-24T08:05:04.414Z","avatar_url":"https://github.com/NSM-Barii.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IoT Exploitation Framework\n\nA comprehensive toolkit for security testing and vulnerability research on IoT devices through BLE, WiFi, and UART attack surfaces.\n\n\u003e ⚠️ **This project is actively in development.** New features and modules are being added regularly. Expect frequent updates and improvements.\n\n---\n\n## Features\n\n- **BLE Exploitation**\n  - Wardriving with automatic data logging\n  - Device enumeration and GATT service dumping\n  - Connection spam attacks\n  - Fuzzing with customizable payloads\n\n- **WiFi Attacks**\n  - SSID scanning and enumeration\n  - Client discovery from specific SSIDs\n  - Deauthentication attacks\n  - Beacon flooding with fake APs\n  - Evil twin / captive portal attacks\n  - WiFi wardriving mode\n\n- **Network Security**\n  - Telnet bruteforce attacks\n\n- **Hardware Protocols** *(Coming Soon)*\n  - UART interface testing\n\n---\n\n## Installation\n\n### Quick Setup\n\n```bash\n# Clone the repository\ngit clone github.com/NSM-Barii/framework\ncd framework/src\n\n# Create and activate virtual environment\npython3 -m venv venv\nsource venv/bin/activate\n\n# Install Python dependencies\npip install -r requirements.txt\n```\n\n### Running the Framework\n\n```bash\n# Must run with sudo for BLE/WiFi access\nsudo venv/bin/python3 main.py\n\n# View help menu\nsudo venv/bin/python3 main.py -h\n```\n\n---\n\n## Dependencies\n\n### BLE Modules\n\nThe BLE modules require BlueZ drivers for Bluetooth Low Energy support.\n\n**Debian/Ubuntu:**\n```bash\nsudo apt-get install bluez bluez-tools libbluetooth-dev\n```\n\n**Arch Linux:**\n```bash\nsudo pacman -S bluez bluez-utils\n```\n\n### Evil Twin Attack\n\nThe Evil Twin module requires `hostapd` and `dnsmasq` for creating fake access points and captive portals.\n\n**Debian/Ubuntu:**\n```bash\nsudo apt update \u0026\u0026 sudo apt install hostapd dnsmasq -y\n```\n\n**Arch Linux:**\n```bash\nsudo pacman -Syu \u0026\u0026 sudo pacman -S hostapd dnsmasq\n```\n\n---\n\n## Usage\n\nRun the framework without arguments to see the help menu:\n\n```bash\nsudo venv/bin/python3 main.py -h\n```\n\n### Command Structure\n\nAll commands use a **prefix system** to organize modules:\n- **`-b*`** = BLE operations\n- **`-w*`** = WiFi operations\n- **Generic flags**: `-t`, `-m`, `-i`, `--channel`\n\n---\n\n### BLE Commands\n\n**BLE Scanning:**\n```bash\nsudo venv/bin/python3 main.py -bs              # Basic BLE scan\nsudo venv/bin/python3 main.py -bsv -t 20      # Scan with vendor lookup, 20s timeout\n```\n\n**BLE Wardriving:**\n```bash\nsudo venv/bin/python3 main.py -bw             # Wardriving mode\nsudo venv/bin/python3 main.py -bwv            # Wardriving with verbose output\n```\n\n**BLE Exploitation:**\n```bash\nsudo venv/bin/python3 main.py -bd -m \u003cMAC\u003e    # Dump GATT services\nsudo venv/bin/python3 main.py -bc -m \u003cMAC\u003e    # Connection spam\nsudo venv/bin/python3 main.py -bcp -m \u003cMAC\u003e   # Connection + pairing spam\nsudo venv/bin/python3 main.py -bf -m \u003cMAC\u003e    # Fuzz all characteristics\n```\n\n**Advanced BLE Fuzzing:**\n```bash\nsudo venv/bin/python3 main.py -bft \u003cUUID\u003e -m \u003cMAC\u003e --send write --response 1\n```\n\n---\n\n### WiFi Commands\n\n**WiFi Scanning:**\n```bash\nsudo venv/bin/python3 main.py -ws -i wlan0    # SSID scan on wlan0\nsudo venv/bin/python3 main.py -ws --channel 11 # SSID scan on channel 11\n```\n\n**WiFi Client Discovery:**\n```bash\nsudo venv/bin/python3 main.py -wc \u003cBSSID\u003e -i wlan0  # Sniff clients from specific AP\n```\n\n**WiFi Deauth Attack:**\n```bash\nsudo venv/bin/python3 main.py -wd \u003cBSSID\u003e --channel 6  # Deauth all clients\nsudo venv/bin/python3 main.py -wd \u003cBSSID\u003e --dst \u003cCLIENT_MAC\u003e  # Deauth specific client\nsudo venv/bin/python3 main.py -wd \u003cBSSID\u003e --reasons 1,6,7  # Custom reason codes\n```\n\n**WiFi Beacon Flood:**\n```bash\nsudo venv/bin/python3 main.py -wb 1 --channel 6  # Beacon flood (portal choice 1-3)\n```\n\n**WiFi Evil Twin:**\n```bash\nsudo venv/bin/python3 main.py -we 5 --channel 6  # Evil twin (portal 1-20)\n```\n\n**WiFi Wardriving:**\n```bash\nsudo venv/bin/python3 main.py -ww -i wlan0      # Wardrive mode (APs only)\nsudo venv/bin/python3 main.py -ww --mode 2      # Wardrive mode (clients + non-beacon)\n```\n\n---\n\n### Other Commands\n\n**Telnet Bruteforce:**\n```bash\nsudo venv/bin/python3 main.py --telnet\n```\n\n---\n\n### Generic Options\n\n```bash\n-t \u003cseconds\u003e      # Scan timeout (default: 10)\n-m \u003cMAC\u003e          # Target MAC address\n-i, --iface       # Network interface (default: wlan1)\n--channel \u003cn\u003e     # WiFi channel (default: 6)\n--mode \u003c1|2\u003e      # Wardrive mode: 1=APs only, 2=clients+non-beacon\n--dst \u003cMAC\u003e       # Deauth destination MAC (default: broadcast)\n--inter \u003cfloat\u003e   # Packet send interval\n--loop \u003cn\u003e        # Packet send loop count\n--count \u003cn\u003e       # Number of packets to send\n--realtime        # Enable realtime packet sending\n--reasons \u003ccodes\u003e # Deauth reason codes (comma-separated, default: 4,5,7,15)\n```\n\n---\n\n## Project Structure\n\n```\nframework/\n├── py_modules/\n│   ├── main.py              # Main entry point\n│   ├── nsm_vars.py          # Centralized configuration\n│   ├── nsm_ble.py           # BLE exploitation modules\n│   ├── nsm_wifi.py          # WiFi attack modules\n│   ├── nsm_telnet.py        # Telnet bruteforce\n│   ├── nsm_database.py      # Database operations\n│   └── requirements.txt     # Python dependencies\n└── README.md\n```\n\n---\n\n## Requirements\n\n### Hardware\n- Linux (Ubuntu/Debian/Arch recommended)\n- Bluetooth adapter (for BLE testing)\n- WiFi adapter with monitor mode support (for WiFi attacks)\n\n### Software\n- Python 3.8+\n- BlueZ drivers (for BLE - see Dependencies)\n- hostapd \u0026 dnsmasq (for Evil Twin - see Dependencies)\n- Root/sudo access (required for low-level network operations)\n\n---\n\n## Disclaimer\n\nThis tool is intended for **authorized security research and testing only**. Unauthorized access to devices or networks is illegal. The author is not responsible for misuse of this framework.\n\n---\n\n## Author\n\n**NSM-Barii**\n\n---\n\n## License\n\n[Specify your license here]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsm-barii%2Fframework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnsm-barii%2Fframework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsm-barii%2Fframework/lists"}