92 lines
3.3 KiB
Markdown
92 lines
3.3 KiB
Markdown
# Messages Mod+
|
|
|
|
A KernelSU-Next module that fixes RCS (Rich Communication Services) on rooted Android devices by reinstalling Google Messages as a user-space app.
|
|
|
|
## The Problem
|
|
|
|
On rooted devices (KernelSU, Magisk, etc.), Google Messages installed as a system app can experience persistent RCS failures — even when Play Integrity passes at the STRONG level. The system-level installation hooks into the telephony stack differently than a user-space app, and this can cause RCS provisioning and registration to silently fail or intermittently break.
|
|
|
|
## How It Works
|
|
|
|
The module disables the system copy of Google Messages and reinstalls it as a user-space update. Android treats it as an `UPDATED_SYSTEM_APP` — the system base remains dormant while the active copy lives in `/data/app/` and behaves like a regular user-installed application. This difference in how the app is loaded and permissioned resolves the RCS issues.
|
|
|
|
The original system APK stays untouched in `/product/priv-app/` — it only becomes active again if you explicitly revert.
|
|
|
|
## Features
|
|
|
|
### KernelSU Module
|
|
- **Action Button**: One-tap apply — disables system Messages, reinstalls as user-space
|
|
- **WebUI Dashboard** with:
|
|
- Live status display (MODDED / SYSTEM / NOT INSTALLED)
|
|
- SMS/MMS database backup & restore
|
|
- RCS database backup & restore
|
|
- Message attachments backup (photos, videos, media)
|
|
- Per-backup restore and delete
|
|
- Revert to stock with one tap
|
|
- **Auto-revert** on module uninstall
|
|
- All backups stored at `/sdcard/MessagesModPlus/`
|
|
|
|
### Standalone Script
|
|
- Runs from a computer via ADB
|
|
- Auto-detect or manual package configuration
|
|
- Interactive menu with colored output
|
|
- Same full functionality as the module
|
|
|
|
## Installation
|
|
|
|
### KernelSU-Next Module
|
|
1. Download `MessagesModPlus-v1.0.0.zip` from Releases
|
|
2. Open KernelSU Manager
|
|
3. Go to Modules > Install from storage
|
|
4. Select the zip file
|
|
5. Open the module's WebUI or press the Action button
|
|
|
|
### Standalone Script (via ADB)
|
|
```bash
|
|
chmod +x messages_mod_standalone.sh
|
|
./messages_mod_standalone.sh
|
|
```
|
|
|
|
Requirements:
|
|
- ADB connected to a rooted device
|
|
- Root shell access (KernelSU, Magisk, etc.)
|
|
|
|
## After Applying
|
|
|
|
1. Open Google Messages on your device
|
|
2. Set it as the default SMS app if prompted
|
|
3. Grant all requested permissions
|
|
4. RCS should provision normally
|
|
|
|
## Reverting
|
|
|
|
Three ways to revert:
|
|
- **WebUI**: Tap "Revert to Stock"
|
|
- **KernelSU Manager**: Remove the module (auto-reverts via uninstall.sh)
|
|
- **Standalone**: Select option 3 from the menu
|
|
|
|
## File Structure
|
|
|
|
```
|
|
MessagesModPlus/
|
|
├── module.prop # Module metadata
|
|
├── customize.sh # Installer
|
|
├── action.sh # Action button - runs apply
|
|
├── uninstall.sh # Auto-revert on module removal
|
|
├── scripts/
|
|
│ └── messages_mod.sh # Core operations (all commands)
|
|
├── webroot/
|
|
│ └── index.html # WebUI dashboard
|
|
└── messages_mod_standalone.sh # Standalone ADB script
|
|
```
|
|
|
|
## Compatibility
|
|
|
|
- Tested on Pixel devices with KernelSU-Next
|
|
- Should work with any rooted Android device running Google Messages
|
|
- Requires Android 10+ (API 29+)
|
|
|
|
## License
|
|
|
|
Free for personal use. Redistribution, modification, or use beyond personal purposes requires approval. See LICENSE for full terms.
|