Skip to content

Root Plus, Request Root Access and Run Root Commands Easily with this Flutter Plugin.

License

Notifications You must be signed in to change notification settings

zaher-neon/root_plus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Root Plus - Run Root Commands Easily

Package Version Flutter Version Package License

A Flutter plugin to request root access and execute privileged commands on rooted Android devices.

Features

  • Request root access
  • Execute single or multiple root commands
  • Get command output and error streams
  • Simple, clean API

Installation

Change NDK Version to 27.0.12077973 or Newer:

android {
    ndkVersion = "27.0.12077973"
    ...
}

Install Plugin:

flutter pub add root_plus

Usage Guide

1. Import the package

import 'package:root_plus/root_plus.dart';

2. Request Root Access

Check if root access is available:

bool hasRoot = await RootPlus.requestRootAccess();

if (hasRoot) {
  print('Root access granted!');
  
} else {
  print('Root access denied or device not rooted');
}

3. Execute Commands

Single Command:

try {
  String result = await RootPlus.executeRootCommand('pm list packages');
  print('Installed packages: $result');
  
} on RootCommandException catch (e) {
  print('Command failed: ${e.message}');
}

Multiple Commands (using \n):

try {
  String result = await RootPlus.executeRootCommand("echo Hello\necho World\npm list packages");
  print('Commands output: $result');
  
} on RootCommandException catch (e) {
  print('Error executing commands: ${e.message}');
}

Exceptions

All methods may throw RootCommandException with these properties:

  • code: Error type (e.g., "COMMAND_FAILED")
  • message: Human-readable error message
  • details: Additional error details (often the command output)

Requirements

  • Rooted Android Phone
  • Tested on Android 15, I didn't tested on other android versions.

Warning

⚠️ Use with caution! Root access gives complete control over the device. Incorrect commands can brick your device.

Author

Developed by Zaher

About

Root Plus, Request Root Access and Run Root Commands Easily with this Flutter Plugin.

Topics

Resources

License

Stars

Watchers

Forks

Contributors