Skip to content

Latest commit

 

History

History
121 lines (111 loc) · 7.93 KB

README.md

File metadata and controls

121 lines (111 loc) · 7.93 KB

BLEShark Nano Firmware 📶

alt text

This project uses the BLEShark Nano development board (based on the ESP-32) to create a versatile tool for spamming Bluetooth Low Energy (BLE) and Wi-Fi networks with a sleek OLED interface.

Updating 🛠️

⚙️ To update your BLEShark, follow these steps:

  1. Open the settings menu on your BLEShark
  2. Select "Update"
  3. Everything will be completed for you!

*If you are not near your Wi-Fi network, the update will not work.*

Features 🚀

💻 Pentesting

  • Bluetooth Low Energy (BLE) Spamming: Floods devices with spoofed BLE advertisements.
    • Android spam,
    • Windows spam,
    • iOS spam,
    • Samsung spam,
    • and Spam All.
  • Wi-Fi Network Spamming: Spams hundreds of Wi-Fi networks with beacon packets, including:
    • Rickrolls
    • Random networks
    • Funny networks
    • Duplicate networks
  • Targeted Wi-Fi Network Spamming: Spams hundreds of the same Wi-Fi networks with beacon packets.
  • Wi-Fi Deauth Attack: Deauthenticates (kicks out) devices off a 2.4Ghz Wi-Fi network.
  • Wi-Fi Captive Portals: Create any captive portal of any HTML code. By default, it is a fake Gooooo (gle) login. This takes user-submitted passwords and saves them onto the device.
  • Bad-BT: Inject custom scripts to devices with Bluetooth.

📝 Apps

  • Keypad: A mini keypad. Assign up to 8 different commands!
  • TxtViewer: 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.
  • TikTok Scroller: Connects to your phone and will execute various functions for TikTok depending on what button you press.
  • Stopwatch: A simple stopwatch. Press [L] to reset, [S] to pause/unpause.
  • Timers: A simple timer.

🎮 Games

  • Flappy Bird: Fly through the pipes!
  • Space Invaders: Shoot down your enemies!
  • Pong w/AI: Try to defeat the pong AI! (unlimited ATM)
  • Breakout: Try to destroy all the blocks!
  • T-Rex: It's the classic "no internet" game!

⚙️ Settings

  • Brightness: Customize your BLEShark's brightness
  • Manual Update: Manually update your device through the air.
  • Extra Settings Mode: Features include:
    • Change Wi-Fi Network: Change the Wi-Fi network needed for OTA updates
    • Enable/Disable Emergency Mode: Hold L+R together for 500 ms to open flappy bird anywhere in the device, just in case.
    • BLESpam Delay: Change the delay per packet in BLESpam.
    • Max Targeted Networks: Change how much targeted networks you want to create (the more, the slower they create).
    • Deauth Delay: Change the delay per packet in the deauth attack.
    • Captive Portal SSID Name: Change the Captive Portal SSID Name.
    • Get Captive Portal Creds: Get the saved credentials you recieved with Captive Portal.
    • Clear Captive Portal Creds: Clear the saved credentials you recieved with Captive Portal.
    • Check and Update: Check for updates, and update with BLEShark.
    • Enable/Disable Automatic Updates: Enable or disable auto updates. Will decrease boot time by a tiny bit.
    • Change BadBT Name: Change the BadBT device name.
    • BadBT File: Upload your duckyscript file here.
    • TxtViewer File: Upload your .txt file here.
    • Captive Portal HTML File: Upload your .html file here.
    • Keypad Settings: Edit your keypad commands here.
    • Amazing UI: An amazing, modern UI with transitions and an extra dark mode on the settings page.

😎 Other Features

  • Emergency Mode: Hold L+R together for 500 ms to open flappy bird anywhere in the device, just in case.
  • Automatic Updates: Auto OTA updates.
  • SPIFFS System: Saves and stores almost every little configuration on the device to SPIFFS.
  • A bunch of bitmaps: Includes a bunch of bitmaps to perfect your experience in the menu.

Upcoming Features 🎉

  • Infrared: Control TVs, ACs, LEDs, and much more!
  • Handshake Capture: Save handshakes onto a PCAP file to crack Wi-Fi passwords.
  • PC Monitor: Connect via BLE to monitor your CPU, GPU, Memory and more—perfect for keeping an eye on your hardware while gaming or working.
  • Add some More Games: A racing/drifting game, a platformer, ect...
  • BadUSB: Run custom BadUSB scripts.
  • Captive Portal Credential Detector: When you connect your BLEShark 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).
  • Extreme Emergency Mode: Sets gaming menu as default menu. To unlock the real menu, open a game and press a combo of buttons (or pin). This is so if people ask "what is this device?" you can say "a mini gaming device".
  • Song Switcher: Connect to any device, and control the music playing (previous, next, pause, ect)!
  • Duino-Coin Mining: Mine Duino-Coin on your BLEShark.
  • Custom Apps: Create custom applications for BLEShark.

WARNING‼️

Warning: 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 (the team of BLEShark) are not responsible for any misuse of this device.