MKSHRC

Enhanced Android Shell Environment

Transform your Android shell experience with a powerful UNIX-like toolbox

---

Overview

mkshrc provides a comprehensive, user-friendly shell environment for Android devices. It delivers a minimal yet powerful UNIX-like toolbox featuring essential tools like BusyBox, OpenSSL, curl, Git, Python, and Frida, all wrapped in an intelligent shell configuration that dramatically improves usability.

Key Features

• Complete Toolbox - Pre-compiled binaries for all major Android architectures
• Zero Dependencies - Statically linked binaries work out-of-the-box
• Security Tools - Includes Frida, OpenSSL, and certificate management
• Universal Support - Works on rooted and non-rooted devices
• Smart Aliases - Intuitive shortcuts for common operations
• Auto-Detection - Automatically configures based on device capabilities

Included Tools

Tool	Version	Description
BusyBox	1.36.1.1	Complete UNIX utilities suite with 300+ applets
Git	2.20.1	Version control with smart aliases and helpers
OpenSSL	1.1.1l	Cryptographic operations and SSL/TLS support
curl	7.78.0	HTTP/HTTPS client with full SSL support
Frida	17.2.16 / 16.7.9	Dynamic instrumentation and reverse engineering
supolicy	2.82	SELinux policy manipulation and management
Python	3.13.13	Full Python interpreter with standard library, pip support
KeyDive	3.0.6	Widevine L3 DRM key extraction from Android devices

Quick Start

1. Installation

Method 1: Using ADB (Recommended)

# Push files to device
adb push package/ /data/local/tmp/package
adb push install.sh /data/local/tmp/mkshrc

# Or use the included batch script
install.bat

# Connect to device and install
adb shell
source /data/local/tmp/mkshrc

2. Activation

# Activate the enhanced shell environment
source /data/local/tmp/mkshrc.sh

# Or add to your shell profile for automatic loading
echo 'source /data/local/tmp/mkshrc.sh' >> ~/.bashrc

3. Device Compatibility

Device Type	Auto-Load	Functionality	Notes
Rooted	Automatic	Full Access	Permanent installation
Non-Rooted	Manual	Limited	Requires manual sourcing

Extra Utilities

• update-ca-certificate <path> - Install custom CA certificates into Android system trust store
• restart - Perform soft reboot of Android framework (requires root)
• pull <path> - Safely copy files from system to /data/local/tmp/
• frida {start|status|stop|version} - Manage Frida server lifecycle
• py, python3, pip - Python aliases for running scripts and managing packages
• keydive - Widevine L3 key extraction tool (requires frida-server running on device)
• BusyBox applets - Automatically symlinked (except man)

Architecture Support

Architecture	Target Devices	Status
arm64-v8a	Modern Android devices (64-bit ARM)	Fully Supported
armeabi-v7a	Older Android devices (32-bit ARM)	Fully Supported
x86	Android emulators (32-bit x86)	Fully Supported
x86_64	Android emulators (64-bit x86)	Fully Supported

Package Structure

package/
  arm64-v8a/                 64-bit ARM (most modern devices)
    busybox/
    git/
    openssl/
    curl/
    python/
  armeabi-v7a/               32-bit ARM (older devices)
  x86/                       32-bit x86 (emulators)
  x86_64/                    64-bit x86 (emulators)
  keydive/                   KeyDive Widevine key extractor source
  mkshrc.sh                  Main shell configuration
  source.txt                 Source URLs for packages
  update-ca-certificate.sh   CA certificate updater

Adding New Packages

Development Guidelines

• Adding Packages - Complete guide for adding new tools
• Android NDK Setup - Cross-compilation environment
• Static Linking - Maximum compatibility across devices
• API Level 21+ - Target Android 5.0 and above
• Testing Procedures - Validation on real devices
• Binary Optimization - Size reduction with strip

Available Packages

• vim - Advanced text editor with syntax highlighting
• htop - Interactive process viewer and system monitor
• git - Version control system with smart aliases and helpers
• python - Programming language interpreter with full standard library
• keydive - Widevine L3 DRM key extraction for Android devices

---

Important Notes

Educational & Development Use Only

This project is designed for educational, debugging, and development purposes. Always test in safe environments and understand the implications of system modifications.

Security Considerations

• Review all binaries before deployment
• Understand root access implications
• Use appropriate security measures
• Keep tools updated for security patches

---

Contributing

We welcome contributions! Please read our guidelines and submit pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made for the Android development community

Credit:

• hyugogirubato