FlipNet

FlipNet turns a Flipper Zero into a portable interface for network, system, Internet and automation tools through a connected PC or Android phone.

---

✨ Features

• USB and BLE communication with automatic USB priority
• Dynamic menus based on the active PC or Android companion
• DNS, TLS, HTTP, port scanning and network discovery
• Device health, security, services, VPN and phone information
• Web search, weather, RSS feeds and Wikipedia
• Calculator, units, currency, translation and time tools
• Android application launcher from the Flipper Zero
• Monitors, alerts and protected automation actions
• Targets, groups, favorites and local history
• Declarative desktop plugins without executable code
• Silent background connection checks
• Loading screens shown only for user-requested operations

Unsupported tools are automatically hidden when they are not available on the connected companion.

---

🧩 Architecture

Flipper Zero
    ├── USB CDC ─── PC gateway
    ├── BLE ─────── PC gateway
    ├── USB OTG ─── Android gateway
    └── BLE ─────── Android gateway

In Auto mode, FlipNet tries USB first, then BLE, then switches to Offline when no gateway is available.

---

🚀 Usage

To use this project, follow the steps below from the project directory.

1️⃣ Build the Flipper Zero application

Build the FAP with Docker:

docker compose run --rm --build flipper-build

The generated application is written to:

apps/flipper/dist/flipnet.fap

Build and launch it directly on a connected Flipper Zero from Linux:

docker compose run --rm --build flipper-launch

2️⃣ Install the PC gateway

Install and start the Python gateway:

python -m pip install ./bridge
flipnet-bridge doctor --strict
flipnet-bridge

Linux and Alpine Linux can install it as a system service with:

./bridge/installers/install-linux.sh

3️⃣ Build the Android application

Build the APK with Docker:

docker compose run --rm --build android-build

The generated APK is written to:

apps/android/dist/flipnet-debug.apk

Build and install it on a connected Android device from Linux:

docker compose run --rm --build android-install

---

🧱 Components

Flipper Zero

The FAP provides the menus, connection status, requests and result views. Heavy operations are delegated to the active gateway.

PC gateway

The Python gateway runs on Linux, macOS and Windows. It provides network, system, Internet, monitoring, workspace and plugin services.

Android gateway

The Android companion provides BLE and USB OTG connectivity, phone information, Android applications and a live scrollable console.

---

🧩 Plugins

FlipNet plugins are declarative .flipnet-plugin packages. They cannot contain executable code.

flipnet-bridge plugin validate ./my-plugin.flipnet-plugin
flipnet-bridge plugin install ./my-plugin.flipnet-plugin --sha256 CHECKSUM
flipnet-bridge plugin list

---

🛠️ Useful Commands

make fap             Build the Flipper application
make fap-launch      Build and launch it on the Flipper
make android         Build the Android APK
make android-install Build and install the Android APK
make bridge-wheel    Build the Python gateway wheel
make bridge-install  Install the Python gateway
make clean           Remove generated outputs

---

👤 Author

Give a ⭐️ if this project helped you!

---

📄 License

Copyright © 2026 Macxzew.

This project is licensed under the MIT License.