KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

RvSystem-Monitor

★ 140 Open GitHub ↗

Modern Android system monitoring app using Jetpack Compose and Rust

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚀 RvSystem Monitor

[![Latest Release](https://img.shields.io/github/v/release/Rve27/RvSystem-Monitor)](https://github.com/Rve27/RvSystem-Monitor/releases)
[![Downloads](https://img.shields.io/github/downloads/Rve27/RvSystem-Monitor/total?logo=github&color=FF69B4)](https://github.com/Rve27/RvSystem-Monitor/releases)
[![IzzyOnDroid](https://img.shields.io/endpoint?url=https://apt.izzysoft.de/fdroid/api/v1/shield/com.rve.systemmonitor&label=IzzyOnDroid)](https://apt.izzysoft.de/fdroid/index/apk/com.rve.systemmonitor)
[![IzzyOnDroid Yearly Downloads](https://img.shields.io/badge/dynamic/json?url=https://dlstats.izzyondroid.org/iod-stats-collector/stats/basic/yearly/rolling.json&query=$.['com.rve.systemmonitor']&label=IzzyOnDroid%20yearly%20downloads)](https://apt.izzysoft.de/packages/com.rve.systemmonitor)
[![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?logo=ko-fi&logoColor=white&style=flat)](https://ko-fi.com/rve27)

**RvSystem Monitor** is a high-performance system monitoring solution for Android, merging the expressive power of **Jetpack Compose** with the raw efficiency of **Rust**. It provides low-level hardware insights while maintaining a modern, buttery-smooth user experience.

---

## 🚀 Overview
RvSystem Monitor bridges the gap between high-level UI frameworks and low-level system APIs. By utilizing a Rust-based backend, it minimizes the performance overhead typically associated with frequent polling of kernel files like `/proc` and `/sys`. This hybrid approach allows for real-time monitoring of CPU frequencies, GPU drivers, battery health, and memory usage without compromising the device's responsiveness.

Built with **Material 3 Expressive**, the application offers a visually rich experience with adaptive layouts and sophisticated transitions, making system diagnostics both powerful and beautiful.

---

## 📸 Screenshots

---

## 🛠️ Tech Stack

- **Languages**: Kotlin, Rust, C (via `libc`).
- **Frameworks**: Jetpack Compose, Material 3 Expressive, Hilt DI.
- **Native Bridge**: JNI via `jni-rs`, `cargo-ndk`.
- **Infrastructure**: Gradle Kotlin DSL, Android NDK, Fastlane.
- **Distribution**: Multiple flavors (GitHub, F-Droid) with toggleable update mechanisms.
- **Libraries**: Retrofit, OkHttp, Coil, Jetpack DataStore.

---

## 📂 Project Structure
```text
RvSystem-Monitor/
├── app/                  # Android application module (Kotlin)
│   ├── src/main/java/    # UI, ViewModels, and JNI bridge declarations
│   ├── src/main/jniLibs/ # Compiled native shared libraries (.so)
│   ├── src/main/res/     # App resources and icons
│   └── build.gradle.kts  # Gradle configuration for Android
├── rust/                 # Native monitoring backend (Rust)
│   ├── src/              # Kernel parsing, JNI implementation, and drivers
│   ├── Cargo.toml        # Rust package and dependency metadata
│   └── README.md         # Documentation for the Rust sub-system
├── gradle/               # Build system scripts and version catalogs
├── fastlane/             # Automation for screenshots and deployments
├── LICENSE               # GNU GPL v3.0
└── README.md             # This file
```

---

## 🏗️ Architecture

The project adheres to **Clean Architecture** principles, ensuring a strict separation of concerns and high maintainability.

### The Hybrid Core
- **UI Orchestration**: The Kotlin layer manages the application lifecycle and UI state. It uses ViewModels to expose reactive data streams from Hilt-injected repositories.
- **Native Data Source**: The Rust layer handles the "heavy lifting". It parses system files and interacts with hardware drivers. By mirroring the Linux kernel's structure (`kernel/` for CPU, `mm/` for Memory, and `drivers/` for GPU), it provides an idiomatic and high-performance data source.
- **Optimized JNI Bridge**: Instead of frequent fine-grained calls, the bridge is designed for **batch data retrieval**. Single calls fetch complete data sets (e.g., all CPU metrics at once), significantly reducing context-switching overhead between the JVM and Native code.

---

## ⚙️ Getting Started

### Prerequisites
- **Android Studio** (Ladybug 2024.2.1 or newer)
- **Rust Toolchain** ([rustup.rs](https://rustup.rs/)): Edition 2024 (Stable 1.85+ recommended).
  - Add Android targets: `rustup target add aarch64-linux-android armv7-linux-androideabi`
- **Android NDK** (Version `30.0.14904198` configured)
- **cargo-ndk**: `cargo install cargo-ndk`

### Installation & Build
1. **Clone the repository**:
   ```bash
   git clone https://github.com/Rve27/RvSystem-Monitor.git
   cd RvSystem-Monitor
   ```
2. **Build Native Libraries**:
   ```bash
   ./gradlew :app:buildRustLibraries
   ```
3. **Build the application**:
   Choose the variant you want to build:
   - **GitHub Variant** (Includes auto-updater):
     ```bash
     ./gradlew assembleGithubRelease
     ```
   - **F-Droid Variant** (No updater):
     ```bash
     ./gradlew assembleFdroidRelease
     ```
4. **Install and run (Debug)**:
   Connect an Android device (API 34+) and run:
   ```bash
   ./gradlew installGithubDebug
   ```

---

## 🤝 Contributing
We welcome contributions from the community! Whether you are fixing a bug, adding a feature, or improving documentation, please read our [CONTRIBUTING.md](CONTRIBUTING.md) to get started.

## 💬 Support
- **Issues**: [GitHub Issues](https://github.com/Rve27/RvSystem-Monitor/issues) for bug reports and feature requests.
- **Discussions**: [Telegram Group](https://t.me/rve_enterprises) for questions and ideas.
- **Donate**: [Support the project on Ko-fi](https://ko-fi.com/rve27)

## 📜 License
This project is licensed under the **GNU General Public License v3.0**. See the [LICENSE](LICENSE) file for details.

---

 Built with ❤️ for the Android Community.

RvSystem-Monitor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README