Skip to content

SequoiaSan/FlipperZero-Wifi-ESP8266-Deauther-Module

 
 

Repository files navigation

(WIP)

FlipperZero WiFi ESP8266 Deauther

WiFi Deauther Module for FlipperZero based on ESP8266

This module is full analog of DSTIKE Deauther See this video below to get an idea how it's working.

DSTIKE Deauther

FlipperZero Module link below

Work demonstration

IMAGE ALT TEXT HERE

Controls

  • UP - move list up by one
  • UP (hold) - continuously move list up by one
  • DOWN - move list down by one
  • DOWN (hold) - continuously move list down by one
  • OK - select
  • BACK - one menu back
  • BACK (long press) - exit app

Help project

Feel free to contact me with your proposals and improvements to this projects.

Fork and improve!

Donate if you want to support author ua

SUPPORT

What do you need

  1. Wemos D1 Mini (or Mini Pro) or analog
  2. FlipperZero

How to

Precompiled .bin for ESP and firmware for FlipperZero can be found in latest release

or

How To Flash .bin to ESP

How To Update FlipperZero firmware (choose Install from file)

Or compile firmwares on your own

Flash firmware on Wemos D1 Mini

Compile firmware for FlipperZero with new application

Use next schematics to solder the WiFi Scanner board for FlipperZero

image

How to add new application on FlipperZero

  1. Copy folders and paste directly into root folder of original firmware.
  2. Add new applications category in /fbt_options.py my_apps for example
FIRMWARE_APPS = {
    "default": (
        "crypto_start",
        # Svc
        "basic_services",
        # Apps
        "basic_apps",
        "updater_app",
        "archive",
        
        # My Apps
        "my_apps",
        
        # Settings
        "passport",
        "system_settings",
        "about",
        # Plugins
        "basic_plugins",
        # Debug
        "debug_apps",
    ),
    "unit_tests": (
        "basic_services",
        "unit_tests",
    ),
}
  1. Add new apps category and our app into applications/meta/application.fam
App(
    appid="my_apps",
    name="My applications for main menu",
    apptype=FlipperAppType.METAPACKAGE,
    provides=[
        "esp8266_deauth",
    ],
)
  1. Compile with any method provided by FlipperZero dev team

Issues

If you have issues with unintended app restart then try to add an AMS1117 voltage regulator on 5V to drop it to 3V3 and feed the module. I would recomend do that

image

ESP8266 Deauther Version 2

PICTURE logo
Scan for WiFi devices, block selected connections, create dozens of networks and confuse WiFi scanners!

Difference to Version 3

Version 3 is in development. It is stable to use, but it is very different.
It is command line based, which allows it to offer not just more features, but make them more customizable.

Feature Version 2 Version 3
Web Interface
Display support
Serial Command Line
Scanner
Deauth attack
Beacon attack
Probe attack
Huhnitor support
Signal strength scanner
Authentication scanner
Rogue AP

Installation

Please refer to the installation guide in our wiki.
If you're just looking for the .bin files, go to releases.

About this project

This software allows you to easily perform a variety of actions to test 802.11 wireless networks by using an inexpensive ESP8266 WiFi SoC (System On A Chip).

The main feature, the deauthentication attack, is used to disconnect devices from their WiFi network.
No one seems to care about this huge vulnerability in the official 802.11 WiFi standard, so I took action and enabled everyone who has less than 10 USD to spare to recreate this project.
I hope it raises more attention on the issue. In 2009 the WiFi Alliance actually fixed the problem (see 802.11w), but only a few companies implemented it into their devices and software.
To effectively prevent a deauthentication attack, both client and access point must support the 802.11w standard with protected management frames (PMF).
While most client devices seem to support it when the access point forces it, basically no WiFi access point has it enabled.

Feel free to test your hardware out, annoy these companies with the problem, share this project and push for a fix! This project is also a great way to learn more about WiFi, micro controllers, Arduino, hacking and electronics/programming in general.
But please use this tool responsibly and do not use it against others without their permission!

WiFi Jammer

Many refer to this project as a WiFi jammer. This is problematic, because this firmware is not turning your ESP8266 into a radio or frequency jammer. But this is how most people imagine it without further explaination.

So if you like to learn more about the difference, we made a whole video about it:
Deauther or Jammer: What's the difference?

Supported Development Boards

This firmware can run on any ESP8266, not however on the ESP32!
The most popular development boards, the NodeMCU and Wemos d1 mini, work great for this project.

If you like to support our work, you can buy get a boards made with this project in mind.
They come preflashed with the firmware, so you can start right away.
You can chose between:

Spacehuhn Store:
Our very own store where all revenue goes directly to us and towards the development of new and exciting projects :)
We manufacture and ship from Germany.

Maltronics:
We partnered with Maltronics to bring you high quality hacking gadgets.
They are based in the UK.

DSTIKE:
DSTIKE was our first partner. They manufactured the first official deauther boards.
They offer a wide range of deauthers in a variety of form factors, including a smart watch.
They are based in China, but their products are available through a variety of stores:

Disclaimer

This project is a proof of concept for testing and educational purposes.
Neither the ESP8266, nor its SDK was meant or built for such purposes. Bugs can occur!

Use it only against your own networks and devices!
Please check the legal regulations in your country before using it.
We don't take any responsibility for what you do with this program.

Acknowledgements

A huge thanks to:

for helping out with various things regarding this project and keeping it alive!
Also thanks to everyone working on the libraries used for this project:

We also thank Espressif and their community for this awesome chip and all the software and hardware projects around it and the countless tutorials you can find online!

License

This software is licensed under the MIT License. See the license file for details.