# 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.