YAao,
Y8888b,
,oA8888888b,
,aaad8888888888888888bo,
,d888888888888888888888888888b,
,888888888888888888888888888888888b,
d8888888888888888888888888888888888888,
d888888888888888888888888888888888888888b
d888888P' `Y88888888Ꙩ \,
88888P' Ybaaaa888888 Ꙩ l
a8888' `Y8888P' `V888888
d8888888a `Y8888
AY/'' `\Y8b ``Y8b
Y' `YP ~~
_ __ ____ ____ _________
| | / /___ _/ / / ____ / __/ / ____/ (_)___ ____ ___ __________
| | /| / / __ `/ / / / __ \/ /_ / /_ / / / __ \/ __ \/ _ \/ ___/ ___/
| |/ |/ / /_/ / / / / /_/ / __/ / __/ / / / /_/ / /_/ / __/ / (__ )
|__/|__/\__,_/_/_/ \____/_/ /_/ /_/_/ .___/ .___/\___/_/ /____/
/_/ /_/
Wall of Flippers (WoF) is a Python based project designed for Bluetooth Low Energy (BTLE) exploration. Its primary functionality involves the discovery of the Flipper Zero device and the identification of potential BTLE based attacks. Please keep in mind this is a work in progress and will still continue to get updates.
- Flipper Zero Detection (BT Must be Enabled)
- Flipper Archiving (Saving Past Data)
- Bluetooth Low Energy Attacks
- iOS Crash and Popup BTLE Detection
- Android Crash and Popup BTLE Detection
- Windows Swift Pair BTLE Detection
- LoveSpouse BTLE Detection
- GoLang Support
- hcidump / hcitool support
A few things are required to properly run WoF. We Recommend the Raspberry Pi as its compact and portable! Additionally, it's also required to have a chipset or a USB adapter that supports BTLE.
Additionally, we also now have limited support for Windows and full support for linux at this time.
Another requirement is Python. Debian based install:
$ sudo apt-get install python3
Additionally, bluepy requires the libglib2.0-dev library to be installed. Debian based install:
$ sudo apt-get install python3-pip libglib2.0-dev
Finally, bluepy is required. This can be installed with the following command:
$ sudo pip3 install bluepy
Your install may look different depending if python3 is used
Additionally, if you are having trouble. Feel free to visit this repo for better documentation: https://github.com/IanHarvey/bluepy/
Alright, it's fun for the fun install process. Downloading WoF is quite straightforward as it's a few commands.
I'd recommend using git as this command can be easily used to retrieve the repository. Otherwise, just donwload via GitHub.
$ git clone https://github.com/K3YOMI/Wall-of-Flippers
After installing, navigate to the Wall of Flippers directory
$ cd ./Wall\ of\ Flippers
Next, run under sudo as this part is required to properly use the pyblue functionality.
$ sudo python3 WallofFlippers.py
Another requirement is Python. Windows Based Below:
https://www.python.org/
bleak is required. This can be installed with the following command:
$ pip install bleak
Additional commands may need to be ran for pip to run properly. see: https://stackoverflow.com/questions/23708898/pip-is-not-recognized-as-an-internal-or-external-command
Your install may look different depending if py is used
Additionally, if you are having trouble. Feel free to visit this repo for better documentation: https://github.com/hbldh/bleak
Alright, it's fun for the fun install process. Downloading WoF is quite straightforward as it's a few commands.
I'd recommend using git as this command can be easily used to retrieve the repository. Otherwise, just donwload via GitHub.
$ git clone https://github.com/K3YOMI/Wall-of-Flippers
After installing, navigate to the Wall of Flippers directory
$ cd ./Wall\ of\ Flippers
Next, run this command below to start the python script and wallah! You are now running Wall of Flippers!
$ py WallofFlippers.py
Tad-ah! You are now properly running WoF on your device. Hopefully this small guide works and gets you started on collecting flippers or checking for
BTLE based attacks. Feel free to report bugs as this can help improve WoF. You can modify, release, or use Wall of Flippers in any way you want
as long as proper credit is given to emilia (jbohack) and k3yomi (kiyomi). Thank you!
