arpanjot-coding/AVault

选用指南

AI 根据 README 整理 · 2026/11/1 04:17:18

使用方式

作为 Android 应用，需先通过 Shizuku 授权，然后可自动录制通话，并通过应用界面管理录音、播放和设置自动清理策略。

查看 README 依据

adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh ``` 3. Shizuku will confirm **"Shizuku is running"** with version and API level. ### Authorizing AVault 1. Launch **AVault**. 2. When prompted on the onboarding or dashboard screen, tap **"Authorize"** on the Shizuku permission dialog. 3. AVault binds immediately to the background daemon via Android Binder IPC. --- ## 📊 System Architecture & Data Flow Diagrams ### 1. End-to-End Audio Capture & Encryption Pipeline ```mermaid flowchart TD

Trigger["Periodic Retention Worker\n(Executes on App Start & Daily Alarm)"] --> CheckEnabled{"Auto-Delete Retention\nPolicy Active?"} CheckEnabled -- Disabled --> KeepAll["Retain All Records\n(Storage Untouched)"] CheckEnabled -- Active --> ReadConfig["Read Retention Horizon\n(1d, 7d, 14d, 30d, 60d, 90d, 180d, 1y)"] ReadConfig --> ScanRecords["Query All Encrypted .vault Containers"] ScanRecords --> RecordLoop{"Iterate Each Container"} RecordLoop --> CheckBookmark{"Is Recording\nBookmarked ('Saved')?"}

部署要求

需要 Android 12 至 16+ 设备，并安装 Shizuku 服务以获得免root权限。构建时需要 JDK 17 或 21、Android SDK Platform API 36 及 Build-Tools 36.0.0。

查看 README 依据

- **Git:** Version 2.30+ - **Java Development Kit (JDK):** Version 17 or 21 (Eclipse Temurin or OpenJDK recommended) - **Android SDK:** Platform API 36 (`android-36`), Build-Tools `36.0.0` - **Android Device:** Android 12 (API 31) through Android 16+ ### Step-by-Step Instructions 1. **Clone Repository with Submodules:** ```bash git clone --recurse-submodules https://github.com/arpanjot-coding/AVault.git cd AVault ``` 2. **Configure Local SDK Path:** Create a `local.properties` file in the project root if not automatically configured: ```properties

## ⚡ Shizuku Rootless Privilege Provider Setup AVault relies on **[Shizuku](https://shizuku.rikka.app)** to communicate with privileged Android OS system services (`android.permission.CAPTURE_AUDIO_OUTPUT`, `android.permission.MANAGE_ONGOING_CALLS`) without rooting the handset. ```mermaid flowchart TD UserPhone["Android Handset\n(Android 12 – 16+)"] --> DevOpt["Enable Developer Options\n& Wireless Debugging"] DevOpt --> ShizukuApp["Launch Shizuku App"] subgraph Pairing Method ShizukuApp -->|Method A| WPair["Wireless Debugging Pairing\n(Enter 6-digit PIN on-device)"]

已知限制

作者声明仅用于学术、安全和教育研究目的，禁止用于未经授权的监控。用户需自行确保符合当地通话录音的法律要求。

查看 README 依据

src="https://img.shields.io/github/stars/arpanjot-coding/AVault?style=social" height="20" style="height: 20px; max-height: 20px;" alt="GitHub Stars" /></a></p> --- ## ⚠️ Critical Academic & Security Research Notice > [!WARNING] > ### STRICTLY FOR ACADEMIC, SECURITY, AND EDUCATIONAL RESEARCH PURPOSES ONLY > > **LIMITATION OF LIABILITY & INDEMNIFICATION:**

> - **Wiretapping & Telecommunications Compliance:** Laws regarding recording telephone calls and intercepting digital communications differ significantly across sovereign nations, states, and provinces. Jurisdictions may enforce **one-party consent** (e.g., 18 U.S.C. § 2511 in the United States) or **all-party consent** (e.g., California Penal Code § 632, Germany StGB § 201, and GDPR Article 6).