gmh5225/wall-of-flippers

Wall of Flippers is designed to find Flipper Zero devices using BLE (Bluetooth Low Energy)

Wall of Flippers (WoF)

                            YAao,                            
                             Y8888b, 
                           ,oA8888888b,      
                     ,aaad8888888888888888bo,   
                  ,d888888888888888888888888888b,               
                ,888888888888888888888888888888888b,            
               d8888888888888888888888888888888888888,           
              d888888888888888888888888888888888888888b                 
             d888888P'                    `Y88888888Ꙩ \,             
             88888P'                    Ybaaaa888888  Ꙩ l          
            a8888'                      `Y8888P' `V888888    
          d8888888a                                `Y8888           
         AY/'' `\Y8b                                 ``Y8b
         Y'      `YP                                    ~~
 _       __      ____         ____   _________                           
| |     / /___ _/ / /  ____  / __/  / ____/ (_)___  ____  ___  __________
| | /| / / __ `/ / /  / __ \/ /_   / /_  / / / __ \/ __ \/ _ \/ ___/ ___/
| |/ |/ / /_/ / / /  / /_/ / __/  / __/ / / / /_/ / /_/ /  __/ /  (__  ) 
|__/|__/\__,_/_/_/   \____/_/    /_/   /_/_/ .___/ .___/\___/_/  /____/ 
                                          /_/   /_/

💡 Introduction

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.

🛠️ Features

• 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

---

---

💡 Future Improvements

• GoLang Support
• hcidump / hcitool support

📚 Some Documentation

Requirements

A few things are required to properly run WoF. One of them being a linux based operating system. This is due to the fact that bluepy (the library used to scan for BTLE devices) requires root privileges and only supports linux based systems. Eventually, we will start to support other operating systems. Recommended device to run WoF is a Raspberry Pi as its easily portable. Additionally, it's also required to have a chipset or a USB adapter that supports BTLE.

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/

Installation

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

Conclusion

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!

Support Kiyomi (Developer)

Support Emilia (Contributor)