🤖 Installation on Android (Termux)

🤖 Installation on Android (Termux)

WireTapper can run on Android via Termux, using pip.

1️⃣ Update Termux packages

pkg update && pkg upgrade

2️⃣ Install Python & build tools

pkg install python git

3️⃣ Install WireTapper

pip install wiretapper --break-system-packages

4️⃣ Launch WireTapper

wiretapper start

Or with custom parameters:

# Start on custom port and auto-open browser
wiretapper start --port 8080 --open-browser
 
# Run with python module syntax
python -m wiretapper start

🌐 Access the Web UI

🖥️ Interface	🔗 URL
📡 Main Signal Intelligence Dashboard	http://localhost:8080/map-w (or http://localhost:8080/)
🔵 Bluetooth LE & RPA Radar Interface	http://localhost:8080/btscan

🩹 Troubleshooting

⚠️ cryptography package fails to build

Termux often fails to build the cryptography package from source because it needs Rust and native headers. Fix it with:

pkg install rust binutils python-cryptography

Then retry:

pip install wiretapper --break-system-packages

If it still fails, install cryptography on its own first so pip picks up the pre-built package instead of compiling it:

pkg install python-cryptography
pip install wiretapper --break-system-packages --no-deps
pip install -r WireTapper.txt --break-system-packages

⚠️ Issue	🛠️ Fix
error: can't find Rust compiler	pkg install rust
fatal error: 'openssl/opensslv.h' file not found	pkg install openssl
wiretapper: command not found	Restart Termux, or add $PREFIX/bin to PATH
Permission denied on wireless scan	Termux has limited raw wireless access on Android — some scan features may be restricted by the OS
Port already in use	Run with wiretapper start --port <other_port>