AppControlX

A powerful Android application for controlling app behavior, battery optimization, and system management — using Root or Shizuku.

Features

App Control

• Freeze/Unfreeze - Disable apps without uninstalling (keeps data intact)
• Uninstall - Remove apps for current user while preserving data
• Force Stop - Immediately terminate running applications
• Clear Cache/Data - Clean app storage with size preview
• Batch Operations - Apply actions to multiple apps with progress tracking

Battery Optimization

• Restrict Background - Block apps from running in background
• Allow Background - Permit background execution
• Real-time Status - View current background restriction status per app

Tools

• Activity Launcher - Launch hidden activities from any app (hold to copy path)
• QColor / Display Color - Qualcomm QColor, MediaTek MiraVision, AOSP, Samsung
• Extra Dim - Reduce screen brightness below minimum (Android 12+)
• Notification Log/History - Access notification records
• Battery Optimization - View app battery consumption
• Power Mode - Quick access to power settings
• Device Info & Diagnostic - System information
• Unknown Sources - Control app install permissions
• Manage Apps (AOSP) - Pure AOSP app manager

Action Logs & Rollback

• Action History - Track all operations with timestamps
• Rollback - Reverse battery actions (Freeze/Unfreeze, Restrict/Allow)
• State Snapshots - Automatic backup before actions

UI/UX

• Material 3 Design - Modern, clean interface with icons
• Dark Mode - Full dark theme support
• Multi-language - English & Indonesian
• Search & Filter - Quick app discovery by name, package, or status

Screenshots

Setup	Main	App Info	Batch	Activity Launcher

Tools	Settings	About	Blocklist

Platform Support

Platform	Version	Support
Android Stock	10 - 15	Full
MIUI/HyperOS	12+	Full
Samsung OneUI	3+	Full
ColorOS/Realme	11+	Full
OxygenOS	11+	Full
Custom ROM	Android 10+	Full

Protected System Apps

SafetyValidator blocks critical system packages from being disabled/frozen to prevent bricking. Covers AOSP, Google, Xiaomi, Samsung, OPPO, Vivo, Huawei, OnePlus, Nothing, ASUS, Sony, Motorola, and more.

Requirements

• Android 10+ (API 29)
• One of the following:
  • Root access (Magisk recommended)
  • Shizuku installed and activated (full features, no root needed)

Features Without Root

These features work without Root or Shizuku:

• Tools - All hidden settings shortcuts (Extra Dim, QColor, Notification Log, etc.)
• Activity Launcher - Browse and launch any app's activities
• Autostart Manager - Quick access to OEM autostart settings

Installation

From Release

1. Download the latest APK from Releases
2. Install on your device
3. Complete the setup wizard

Build from Source

git clone https://github.com/risunCode/AppControl-X.git
cd AppControl-X
./gradlew assembleDebug

Architecture

MVVM architecture with Hilt dependency injection.

com.appcontrolx/
├── data/local/         # Room Database
├── di/                 # Hilt modules
├── executor/           # Command execution (Root/Shizuku)
├── model/              # Data classes
├── rollback/           # Action logs & rollback
├── service/            # Business logic
├── ui/                 # Activities, Fragments, Adapters
└── utils/              # Helpers & validators

Key Components

Component	Description
PermissionBridge	Detects execution mode (Root/Shizuku/None)
RootExecutor	Executes commands via libsu with security validation
ShizukuExecutor	Executes commands via Shizuku UserService
BatteryPolicyManager	Manages appops and battery settings
RollbackManager	Action logs and state snapshots
SafetyValidator	Prevents actions on critical system apps

Tech Stack

• Language: Kotlin 1.9
• Min SDK: 29 (Android 10)
• Target SDK: 34 (Android 14)
• Architecture: MVVM + Hilt
• UI: Material 3, ViewBinding
• Async: Coroutines + Flow
• Root: libsu
• Shizuku: Shizuku-API

Commands Reference

App Control

pm disable-user --user 0 <package>    # Freeze
pm enable <package>                    # Unfreeze
pm uninstall -k --user 0 <package>    # Uninstall
am force-stop <package>                # Force stop
pm clear --cache-only <package>        # Clear cache
pm clear <package>                     # Clear data

Battery Control

appops set <package> RUN_IN_BACKGROUND ignore    # Restrict
appops set <package> RUN_IN_BACKGROUND allow     # Allow
appops set <package> WAKE_LOCK ignore            # Disable wake lock

Changelog

See CHANGELOG.md for full history.

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push and open a Pull Request

License

GPL-3.0 License - see LICENSE

Credits

Made with ❤️ by risunCode

Acknowledgments

• libsu - Root shell library
• Shizuku - Elevated API access