📱 Automated Mobile Network Testing Suite for RF Engineers, QA, and Devs

With JNI bindings to native iPerf3, it offers low-level control, intelligent test strategies, and a polished UI — perfect for field diagnostics, automated lab tests, and performance validation on mobile.

⭐️ If you find CellularLab useful, please consider giving it a star — it helps others discover the project and supports development!

A fast, native iPerf3 Android client with TCP/UDP/AI log analysis support. Built with JNI + Android Studio.

Latest signed release: Download from GitHub Releases →

⚠️ Works on Android 10+ (API 29+).
📁 Logs are saved to your Downloads/ folder.

• 🧪 TCP
• 📡 UDP
• 📈 UDP Incremental Ramp-Up
• 🔄 Hybrid TCP+UDP
• 🤖 Smart Adaptive Ramp-Up

• 📤 Upload
• 📥 Download (-R)
• 🔁 Bidirectional (--bidir)

Take full control of your testing with Command Mode — execute custom iPerf3 commands directly:

• 💻 Enter any iperf3 command (e.g. -c 10.0.0.1 -u -b 10M)
• 🎯 Perfect for advanced users needing custom bandwidth, interval, protocol
• 📊 Full live output visible and saved like regular tests

Let your assistant do the heavy lifting!

• ✨ Tap "AI Analyze" on any log from History
• 📑 Generates a structured markdown report:
  • Summary of the test
  • Performance issues (packet loss, jitter, etc.)
  • Recommendations
  • Quality rating (Excellent/Good/Fair/Poor)
• 🪄 Clean, formatted output with headlines, bolds, bullet points
• ⚡ Powered by Google Gemini Flash
• 🔒 Safe — your API key is stored in local.properties and not committed

Great for reports, debugging, and sharing with your network team.

These are ideal for automated testing environments or dynamic network analysis.

• Set custom durations (e.g., 10s, 60s)
• Configure parallel streams
• Customizable reporting interval
• Enable verbose/debug logging
• Auto-scroll control (double-tap to toggle)
• Wait between iterations

• 📉 Real-time iPerf3-style logs (1s interval)
• 📂 Logs saved to Downloads/ folder
• 🧲 Double-tap log view to toggle auto-scroll
• 📤 Share logs via Mail, WhatsApp, Drive, etc.
• 📄 Clean formatting for easy analysis
• 🤖 AI analysis (v2.0) now supported for detailed summaries!

No iPerf server? Use these community-hosted ones:

• 🔗 iperf.fr
• 🔗 R0GGER/public-iperf3-servers

⚠️ May be unstable or offline depending on maintenance.

New users get an in-app walkthrough of the key screens and controls.

Just set up the parameters (IP, protocol, duration) and tap start.

See previous results with clear pass/fail indicators:

• ✅ All tests passed
• ⚠️ Partial success
• ❌ Most failed

You can:

• Tap to open logs
• Share or delete from the UI
• ✨ Analyze with Gemini AI

✨ Tap "AI Analyze" on any log from History

To upgrade to a newer iPerf3 version:

📖 See docs/updating-iperf.md for detailed steps.

Want to dive deeper into how this app was built or learn how to compile iPerf3 for Android?

• 📖 How I Accidentally Vibe-Coded an Android iPerf3 App with AI
• 🛠️ Compiling iPerf3 in Android with CMake and JNI – A Practical Guide
• 📚 User Guide

Follow me on Hashnode for more deep dives:
🌐 @AbhishekIN on Hashnode

This project is open-source under a custom MIT-style license:

• ✅ Personal and non-commercial use allowed
• ❌ Uploading to Play Store or commercial use requires permission

If you build on this, please give credit with a link to the original repo:

🔗 https://github.com/Abhi5h3k/CellularLab