https://github.com/abhi5h3k/cellularlab
📱 CellularLab – iPerf3 Client for Android
https://github.com/abhi5h3k/cellularlab
best-iperf cellular-automaton cmakelists cpp gemini-api gemini-client iperf iperf-android iperf-android-app iperf-auto-run iperf3 iperf3-android iperf3-client jni kotlin-android kotlin-coroutines network network-analysis network-monitoring radio-frequency
Last synced: about 2 months ago
JSON representation
📱 CellularLab – iPerf3 Client for Android
- Host: GitHub
- URL: https://github.com/abhi5h3k/cellularlab
- Owner: Abhi5h3k
- License: other
- Created: 2025-06-19T17:13:03.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-08-08T12:31:46.000Z (about 2 months ago)
- Last Synced: 2025-08-08T14:34:02.415Z (about 2 months ago)
- Topics: best-iperf, cellular-automaton, cmakelists, cpp, gemini-api, gemini-client, iperf, iperf-android, iperf-android-app, iperf-auto-run, iperf3, iperf3-android, iperf3-client, jni, kotlin-android, kotlin-coroutines, network, network-analysis, network-monitoring, radio-frequency
- Language: C
- Homepage:
- Size: 998 KB
- Stars: 12
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📡 CellularLab – Advanced iPerf3 Client for Android
[](https://www.linkedin.com/in/abhi5h3k/)
[](https://stackoverflow.com/users/6870223/abhi?tab=profile)
📱 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!
---
## 🖼️ UI Preview
> _A fast, native [iPerf3](https://github.com/esnet/iperf) Android client with TCP/UDP/AI log analysis support. Built with JNI + Android Studio._
## 📥 Download APK
Latest signed release: [Download from GitHub Releases →](https://github.com/Abhi5h3k/CellularLab/releases)
> ⚠️ Works on Android 10+ (API 29+).
> 📁 Logs are saved to your `Downloads/` folder.
---
## 🚀 Features & Capabilities
### ✅ Protocol Support
- 🧪 **TCP**
- 📡 **UDP**
- 📈 **UDP Incremental Ramp-Up**
- 🔄 **Hybrid TCP+UDP**
- 🤖 **Smart Adaptive Ramp-Up**
### ✅ Test Directions
- 📤 Upload
- 📥 Download (`-R`)
- 🔁 Bidirectional (`--bidir`)
---
## 🔧 Command Mode
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
---
## 🤖 Gemini AI Analysis
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.
---
## 🧠 Smart Test Strategies
| 🚀 Strategy | 📝 Description |
| -------------------------- | --------------------------------------------------------------------------------- |
| 📈 **Incremental Ramp-Up** | Gradually increases UDP bandwidth to simulate real-time scaling and detect limits |
| 🔄 **Hybrid TCP+UDP** | Uses TCP to estimate capacity, then runs UDP at that level |
| 🧠 **Smart Ramp-Up** | Increases UDP load only if ≥90% of packets succeed in previous step |
These are ideal for **automated testing environments** or **dynamic network analysis**.
---
## ⚙️ Additional Test Options
- 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
---
## 📁 Output, Logs & History
- 📉 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!
---
## 🌐 Public iPerf3 Servers
No iPerf server? Use these community-hosted ones:
- 🔗 [iperf.fr](https://iperf.fr/iperf-servers.php)
- 🔗 [R0GGER/public-iperf3-servers](https://github.com/R0GGER/public-iperf3-servers)
> ⚠️ May be unstable or offline depending on maintenance.
---
## 📸 Demo Gallery
### 1. 🚀 First-Time User Guide
New users get an in-app walkthrough of the key screens and controls.
---
### 2. 🎯 Run a Test
Just set up the parameters (IP, protocol, duration) and tap start.
---
### 3. 📊 History & Log Management
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
---
### 4. 🤖 AI Assistant
✨ Tap "AI Analyze" on any log from **History**
---
## 🛠️ Development Info
| Component | Details |
|------------------|--------------------------------------|
| **IDE** | Android Studio `Narwhal 2025.1.1` |
| **NDK Version** | `28.1.13356709` |
| **iPerf Version**| `3.19` (Native C via JNI) |
| **Min SDK** | API 29 |
| **Target SDK** | API 35 |
| **ABI Support** | `armeabi-v7a`, `arm64-v8a` |
| **Build Types** | Debug & Signed Release |
---
## 🛠️ Updating iPerf3 Version
To upgrade to a newer iPerf3 version:
📖 See [`docs/updating-iperf.md`](docs/updating-iperf.md) for detailed steps.
---
## 📚 Articles & Guides
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](https://iper3.hashnode.dev/how-i-accidentally-vibe-coded-an-android-iperf3-app-with-ai)
- 🛠️ [Compiling iPerf3 in Android with CMake and JNI – A Practical Guide](https://iper3.hashnode.dev/compiling-iperf3-in-android-with-cmake-and-jni-a-practical-guide)
- 📚 [User Guide](https://android-iperf3.hashnode.space/cellular-lab/v1.0?t=1754656238992)
Follow me on Hashnode for more deep dives:
🌐 [@AbhishekIN on Hashnode](https://hashnode.com/@AbhishekIN)
---
## 📜 License
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](https://github.com/Abhi5h3k/CellularLab)