{"id":18884117,"url":"https://github.com/grdashark/bleshark","last_synced_at":"2025-04-07T09:16:31.213Z","repository":{"id":253278215,"uuid":"802135999","full_name":"grdashark/BLEShark","owner":"grdashark","description":"An ESP-32 based multi-tool for pentesting.","archived":false,"fork":false,"pushed_at":"2025-03-14T18:57:35.000Z","size":10081,"stargazers_count":103,"open_issues_count":2,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-31T08:12:02.658Z","etag":null,"topics":["badbt","badusb","bluetooth","bluetooth-low-energy","captive-portal","esp32","handshake","multi-tool","pentesting","portal","wi-fi"],"latest_commit_sha":null,"homepage":"https://infishark.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grdashark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-05-17T15:30:42.000Z","updated_at":"2025-03-28T23:41:52.000Z","dependencies_parsed_at":"2024-09-14T23:08:53.567Z","dependency_job_id":"2b2a00a6-23b7-4d99-96e3-e8c136f2e37a","html_url":"https://github.com/grdashark/BLEShark","commit_stats":null,"previous_names":["grdashark/bleshark"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grdashark%2FBLEShark","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grdashark%2FBLEShark/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grdashark%2FBLEShark/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grdashark%2FBLEShark/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grdashark","download_url":"https://codeload.github.com/grdashark/BLEShark/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247622988,"owners_count":20968575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["badbt","badusb","bluetooth","bluetooth-low-energy","captive-portal","esp32","handshake","multi-tool","pentesting","portal","wi-fi"],"created_at":"2024-11-08T07:11:07.351Z","updated_at":"2025-04-07T09:16:31.189Z","avatar_url":"https://github.com/grdashark.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\" style=\"color: #4A90E2; font-family: Arial, sans-serif;\"\u003e\n  BLEShark Nano Firmware 📶\n\u003c/h1\u003e\n\n![alt text](https://github.com/grdashark/BLEShark/blob/main/Images/Alternative%20Angle%20for%20Main%20Image.png?raw=true)\n\n\u003cp align=\"center\" style=\"font-family: Arial, sans-serif; font-size: 18px;\"\u003e\n \u003ci\u003e The official BLEShark Nano firmware!\u003c/i\u003e\n\u003c/p\u003e\n\n## \u003cspan style=\"color: #E67E22;\"\u003eUpdating 🛠️\u003c/span\u003e\n\n\u003cp style=\"font-family: Arial, sans-serif;\"\u003e\n  ⚙️ \u003cstrong\u003eTo update your BLEShark Nano, follow these steps:\u003c/strong\u003e\n\u003c/p\u003e\n\u003col style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003eOpen the settings menu on your BLEShark\u003c/li\u003e\n  \u003cli\u003eSelect \"Update\"\u003c/li\u003e\n  \u003cli\u003eEverything will be completed for you!\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp style=\"font-family: Arial, sans-serif; font-style: italic;\"\u003e\n  *If you are not near your Wi-Fi network, the update will not work.*\n\u003c/p\u003e\n\n## \u003cspan style=\"color: #27AE60;\"\u003eFeatures 🚀\u003c/span\u003e\n\n\u003ch3\u003e\u003cstrong\u003e💻 Pentesting\u003c/strong\u003e\u003c/h3\u003e\n\u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003e\u003cstrong\u003eBluetooth Low Energy (BLE) Spamming\u003c/strong\u003e: Floods devices with spoofed BLE advertisements.\u003c/li\u003e\n  \u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n    \u003cli\u003eAndroid spam,\u003c/li\u003e\n    \u003cli\u003eWindows spam,\u003c/li\u003e\n    \u003cli\u003eiOS spam,\u003c/li\u003e\n    \u003cli\u003eSamsung spam,\u003c/li\u003e\n    \u003cli\u003eand Spam All.\u003c/li\u003e\n  \u003c/ul\u003e\n  \u003cli\u003e\u003cstrong\u003eWi-Fi Network Spamming\u003c/strong\u003e: Spams hundreds of Wi-Fi networks with beacon packets, including:\u003c/li\u003e\n  \u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n    \u003cli\u003eRickrolls\u003c/li\u003e\n    \u003cli\u003eRandom networks\u003c/li\u003e\n    \u003cli\u003eFunny networks\u003c/li\u003e\n    \u003cli\u003eDuplicate networks\u003c/li\u003e\n  \u003c/ul\u003e\n  \u003cli\u003e\u003cstrong\u003eTargeted Wi-Fi Network Spamming\u003c/strong\u003e: Spams hundreds of the \u003cstrong\u003esame\u003c/strong\u003e Wi-Fi networks with beacon packets.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eWi-Fi Deauth Attack\u003c/strong\u003e: Deauthenticates (kicks out) devices off a 2.4Ghz Wi-Fi network.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eWi-Fi Deauth Checker\u003c/strong\u003e: Check for deauth attacks.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eWi-Fi Captive Portals\u003c/strong\u003e: Create any captive portal of any HTML code. By default, it is a fake Gogl. login. This takes user-submitted passwords and saves them onto the device.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eBad-BT\u003c/strong\u003e: Inject custom scripts to devices with Bluetooth. The BLEShark Nano comes pre-loaded with many scripts: pranks, mobile, general, and dangerous scripts. Of course, use this \u003cstrong\u003eonly on your own hardware!!\u003c/strong\u003e We can not stress this enough.\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3\u003e\u003cstrong\u003e🚨 Infrared\u003c/strong\u003e\u003c/h3\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003cstrong\u003eReceiver\u003c/strong\u003e: Receive any Infrared signal, and save it onto the BLEShark Nano.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eTransmitter\u003c/strong\u003e: Transmit individual commands saved on the BLEShark Nano.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eTV-B-Gone\u003c/strong\u003e: Turn on/off any TV!\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eRemote\u003c/strong\u003e: Think of it as the \"shortcut\" version of the transmitter app.\u003c/li\u003e\n  \u003c/ul\u003e\n\u003ch3\u003e\u003cstrong\u003e📝 Apps\u003c/strong\u003e\u003c/h3\u003e\n\u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003e\u003cstrong\u003eKeypad\u003c/strong\u003e: A mini keypad. Assign up to 8 different commands!\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eTxtViewer\u003c/strong\u003e: View and scroll through custom text files for notes, presentations, and documentation. Supports smooth scrolling, word wrapping, and a built-in scroll bar for easy navigation.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eTikTok Scroller\u003c/strong\u003e: Connects to your phone and will execute various functions for TikTok depending on what button you press.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eStopwatch\u003c/strong\u003e: A simple stopwatch. Press [L] to reset, [S] to pause/unpause.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eTimers\u003c/strong\u003e: A simple timer.\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3\u003e\u003cstrong\u003e🎮 Games\u003c/strong\u003e\u003c/h3\u003e\n\u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003e\u003cstrong\u003eFlappy Bird\u003c/strong\u003e: Fly through the pipes!\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eSpace Invaders\u003c/strong\u003e: Shoot down your enemies!\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003ePong w/AI\u003c/strong\u003e: Try to defeat the pong AI! (unlimited ATM)\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eBreakout\u003c/strong\u003e: Try to destroy all the blocks!\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eT-Rex\u003c/strong\u003e: It's the classic \"no internet\" game!\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eRacer\u003c/strong\u003e: Race around through traffic!\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch3\u003e\u003cstrong\u003e⚙️ Settings\u003c/strong\u003e\u003c/h3\u003e\n\u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003e\u003cstrong\u003eBrightness\u003c/strong\u003e: Customize your BLEShark's brightness\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eManual Update\u003c/strong\u003e: Manually update your device through the air.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eExtra Settings Mode\u003c/strong\u003e: Features include:\u003c/li\u003e\n  \u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n    \u003cli\u003e\u003cstrong\u003eChange Wi-Fi Network\u003c/strong\u003e: Change the Wi-Fi network needed for OTA updates\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eEnable/Disable Emergency Mode\u003c/strong\u003e: Hold L+R together for 500 ms to open flappy bird anywhere in the device, just in case.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eBLESpam Delay\u003c/strong\u003e: Change the delay per packet in BLESpam.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eMax Targeted Networks\u003c/strong\u003e: Change how much targeted networks you want to create (the more, the slower they create).\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eDeauth Delay\u003c/strong\u003e: Change the delay per packet in the deauth attack.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eCaptive Portal SSID Name\u003c/strong\u003e: Change the Captive Portal SSID Name.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eGet Captive Portal Creds\u003c/strong\u003e: Get the saved credentials you recieved with Captive Portal.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eClear Captive Portal Creds\u003c/strong\u003e: Clear the saved credentials you recieved with Captive Portal.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eCheck and Update\u003c/strong\u003e: Check for updates, and update with BLEShark.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eEnable/Disable Automatic Updates\u003c/strong\u003e: Enable or disable auto updates. Will decrease boot time by a tiny bit.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eChange BadBT Name\u003c/strong\u003e: Change the BadBT device name.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eBadBT File\u003c/strong\u003e: Upload your duckyscript file here.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eTxtViewer File\u003c/strong\u003e: Upload your .txt file here.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eCaptive Portal HTML File\u003c/strong\u003e: Upload your .html file here.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eKeypad Settings\u003c/strong\u003e: Edit your keypad commands here.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003eAmazing UI\u003c/strong\u003e: An amazing, modern UI with transitions and an extra dark mode on the settings page.\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/ul\u003e\n\u003ch3\u003e\u003cstrong\u003e😎 Other Features\u003c/strong\u003e\u003c/h3\u003e\n\u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003e\u003cstrong\u003eEmergency Mode\u003c/strong\u003e: Hold L+R together for 500 ms to open flappy bird anywhere in the device, just in case.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eAutomatic Updates\u003c/strong\u003e: Auto OTA updates.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eSPIFFS System\u003c/strong\u003e: Saves and stores almost every little configuration on the device to SPIFFS.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eScreensaver\u003c/strong\u003e: A small but cool feature; a DVD-Style screensaver.\u003c/li\u003e\n\u003c/ul\u003e\n\n## \u003cspan style=\"color: #9B59B6;\"\u003eUpcoming Features 🎉\u003c/span\u003e\n\n\u003cul style=\"font-family: Arial, sans-serif;\"\u003e\n  \u003cli\u003e\u003cstrong\u003eHandshake Capture\u003c/strong\u003e: Save handshakes onto a PCAP file to crack Wi-Fi passwords.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003ePC Monitor\u003c/strong\u003e: Connect via BLE to monitor your CPU, GPU, Memory and more—perfect for keeping an eye on your hardware while gaming or working.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eBadUSB\u003c/strong\u003e: Add BadUSB on top of of Bad-BT.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eCaptive Portal Credential Detector\u003c/strong\u003e: When you connect your BLEShark Nano to a hotspot or a Wi-Fi network, The Captive Portal will check if the creds are valid as the user is typing it in. We will provide different services (FB, Google, X, ect).\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eExtreme Emergency Mode\u003c/strong\u003e: Sets gaming menu as default menu. To unlock the real menu, open a game and press a combo of buttons (or pin). This is if people ask \"what is this device?\" you are able to say \"a mini gaming device\".\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eCustom Apps\u003c/strong\u003e: Create custom applications for BLEShark Nano.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eCustomize Infrared Remote/Command Names\u003c/strong\u003e: Customize the IR remote/command names through the extra settings mode.\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eFix BLESpam Functionality\u003c/strong\u003e: Make the BLESpam functionality work better (a new bug)\u003c/li\u003e\n  \u003cli\u003e\u003cstrong\u003eBattery Monitor\u003c/strong\u003e: Monitor the BLEShark Nano's battery level.\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003ch2 align=\"center\" style=\"color: #E74C3C; font-family: Arial, sans-serif;\"\u003e\n  WARNING‼️\n\u003c/h2\u003e\n\u003cp align=\"center\" style=\"color: #E74C3C; font-family: Arial, sans-serif; font-weight: bold;\"\u003e\n  \u003cstrong\u003eWarning:\u003c/strong\u003e This device is intended solely for security purposes. It is designed to help identify and fix vulnerabilities in BLE and Wi-Fi networks. Unauthorized use for hacking or any other malicious activity is illegal and strictly prohibited. We, InfiShark Tech, are not responsible for any misuse of this device.\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\n\u003ca href=\"https://infishark.com\"\u003eOur Website\u003c/a\u003e\n\u003c/h3\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrdashark%2Fbleshark","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrdashark%2Fbleshark","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrdashark%2Fbleshark/lists"}