Skip to content

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

License

Notifications You must be signed in to change notification settings

risunCode/AppControl-X

Repository files navigation

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
Setup 1 Main Apps App Info Batch Activity Launcher
Tools Settings About Blocklist
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

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published