Wall of Flippers on debian linux is currently one of the best ways to run Wall of Flippers. Mostly due to it being stable and having a lot of support for BLE. To start off, it is highly recommened to follow all instructions we provide unless you know what you are doing. To get started, we need to set up the directory and install the required packages.

Before we continue with the installation, we need to make sure our system is up to date. To do this update through the command line.

sudo apt-get update && sudo apt-get upgrade -y

To start off, we need to clone the repository and install the required packages. To do this, we need to run the following commands in the terminal. However, if you do not have git installed, you can simply install it by running this command (apt package manager only):

sudo apt-get install git
git clone https://www.github.com/K3YOMI/Wall-of-Flippers
cd ./Wall-of-Flippers

Installing python3 is required to run wall of flippers and installs it's dependencies. The command below will install python3 for you.

sudo apt-get install python3

Installing the required packets and dependencies can be done in three ways with this install. You can choose to use the terminal with the commands below, use requirements.txt, or you use the easy install script within Wall of Flippers. The choice is up to you depending on your preference. To get started with the terminal way. We will use these commands below.

sudo apt-get install libglib2.0-dev
sudo apt-get install python3-bluez
python3 -m venv .venv
source .venv/bin/activate

################## PACKAGES ########################
# requirement.txt method
python3 -m pip install -r requirements.txt
# command method
python3 -m pip install bluepy
python3 -m pip install requests
python3 -m pip install git+https://github.com/pybluez/pybluez.git#egg=pybluez
################## PACKAGES ########################

deactivate

If you would like to use the easy install script, you can use the following commands below.

bash wof.sh

You should get a prompt upon startup, about setting up a managed environment, feel free to let it do for you. Then once an environemnet is complete run wof.sh again and press 4 for the auto install process.

Once you have finished with all the dependencies and requirements, you can now run Wall of Flippers. To do this, you can run the following command below.

bash wof.sh

Please keep note that running Wall of Flippers requires elevated privileges. Hence the sudo command. If you do not want to run Wall of Flippers with elevated privileges, you can run the following command below.

sudo chmod +x WallofFlippers.py
./WallofFlippers.py

To start off, is is highly recommened to follow all instructions we provide unless you know what you are doing. To get started, we need to set up the directory and install the required packages.

Before we continue with the installation, we need to make sure our system is up to date. To do this update through the command line.

sudo dnf update && sudo dnf upgrade -y

To start off, we need to clone the repository and install the required packages. To do this, we need to run the following commands in the terminal. However, if you do not have git installed, you can simply install it by running this command (apt package manager only):

sudo dnf install git
git clone https://www.github.com/K3YOMI/Wall-of-Flippers
cd ./Wall-of-Flippers

Installing python3 is required to run wall of flippers and installs it's dependencies. The command below will install python3 for you.

sudo dnf install python3

Installing the required packets and dependencies can be done in three ways with this install. You can choose to use the terminal with the commands below, use requirements.txt, or you use the easy install script within Wall of Flippers. The choice is up to you depending on your preference. To get started with the terminal way. We will use these commands below.

sudo dnf install glib2-devel
sudo dnf install python3-bluez
python3 -m venv .venv
source .venv/bin/activate

################## PACKAGES ########################
# requirement.txt method
python3 -m pip install -r requirements.txt
# command method
python3 -m pip install bluepy
python3 -m pip install requests
python3 -m pip install git+https://github.com/pybluez/pybluez.git#egg=pybluez
################## PACKAGES ########################

deactivate

If you would like to use the easy install script, you can use the following commands below.

bash wof.sh

You should get a prompt upon startup, about setting up a managed environment, feel free to let it do for you. Then once an environemnet is complete run wof.sh again and press 4 for the auto install process.

Once you have finished with all the dependencies and requirements, you can now run Wall of Flippers. To do this, you can run the following command below.

bash wof.sh

Please keep note that running Wall of Flippers requires elevated privileges. Hence the sudo command. If you do not want to run Wall of Flippers with elevated privileges, you can run the following command below.

sudo chmod +x WallofFlippers.py
./WallofFlippers.py

Windows is currently not fully supported. However, you can still run Wall of Flippers on Windows. A few missing features like the ability to detect advertisment attacks and ability to send advertisments. However the detection of the Flipper Zero device is still supported. To get started, we will need to clone the repository and install the required packages. To do this, we need to run the following commands in the command prompt. However, if you do not have git installed, you can simply install it by downloading it from the official website.

Download and install git from here. Once you have downloaded it, you can now run the following commands below.

git clone https://www.github.com/K3YOMI/Wall-of-Flippers
cd ./Wall-of-Flippers

This step is quite straightforward as we will be installing python and pip. To do this, we will need to download the latest version of python from the official website. Once you have downloaded the installer, you can run it and install python. Please make sure to check the box that says Add Python to PATH. This will allow you to run python from the command prompt. Once you have installed python, you can now install the required packages. To do this, we will need to run the following commands below.

pip install bleak
pip install requests

Alternatively, you can use the requirements.txt file to install the required packages. To do this, we will need to run the following commands below.

pip install -r requirements.txt

If you would like to use the easy install script, you can use the following commands below.

python WallofFlippers.py

You should get a prompt upon startup, press 4 for the easy install and follow the directions and prompts for the install.

If you are having issues with pip being not recognized as a command, please refer to this question on Stack Overflow.

Once you have finished with all the dependencies and requirements, you can now run Wall of Flippers. To do this, you can run the following command below.

python WallofFlippers.py

Please keep note that this is a watered down version of Wall of Flippers. Hence the lack of features. If you would like to run the full version of Wall of Flippers, please refer to the Linux Install Guide above.

You can run Wall of Flippers on Pwnagotchi to scan and save flippers data that your little friend find near them.

Login as root on your Pwnagotchi and run:

cd /root && git clone https://www.github.com/cyberartemio/Wall-of-Flippers && cd Wall-of-Flippers

Create virtual environment and install Python dependencies.

python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt && deactivate

Create the systemd service in /etc/systemd/system/wof.service.

[Unit]
Description=WallofFlippers - A simple and easy way to find Flipper Zero Devices and Bluetooth Low Energy Based Attacks

[Service]
ExecStart=/root/Wall-of-Flippers/.venv/bin/python /root/Wall-of-Flippers/WallofFlippers.py --no-ui wof -d 0
WorkingDirectory=/root/Wall-of-Flippers/
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=wof
User=root
Group=root
Environment="PYTHONUNBUFFERED=1"

[Install]
WantedBy=multi-user.target

Then run:

systemctl daemon-reload

To start Wall of Flippers daemon, run:

systemctl start wof

If you want to start the daemon on boot, run:

systemctl enable wof

Once you start the daemon, Wall of Flippers should be running and scanning for nearby Flippers. You can check the status by running:

systemctl status wof

If you want to see the data of Wall of Flippers on you Pwnagotchi screen, install CyberArtemio's wof-pwnagotchi-plugin. Follow the installation steps here.