Home/Docs/Manual v14.0

ARM64 Architecture•Linux PRoot

OFFICIAL SPECIFICATION & GUIDE

RootX IDE & Linux Terminal Manual

Everything you need to compile, build, run, and debug native code on Android. From JNI hardware bridges and PRoot Linux containers to OTG shortcut maps, package management, and system diagnostics.

Kernel EngineNDK Native + PRoot

Distro SupportUbuntu, Alpine, Kali

RuntimesNode, Python, Go, PHP

Hardware KeymapFull OTG & Bluetooth

Module 01

Core Architecture & Execution Engines

RootX is engineered as an on-device integrated development environment and terminal emulator. Unlike cloud-streamed IDEs that require persistent low-latency internet, RootX compiles and executes code directly on your mobile device’s native ARM64 CPU.

A. Native NDK / JNI Direct Bridge

Languages such as Node.js v22, Python 3, PHP 8, and Go are pre-compiled for the Android NDK (ARM64-v8a). System calls dispatch through JNI directly to native process streams without virtualization overhead, unlocking raw processor speed.

Zero CPU virtualization penalty

B. User-Space PRoot Linux Containers

PRoot intercepts Linux syscalls using the kernel ptrace() mechanism, emulating chroot and bind mounts entirely in user space. This allows running full Ubuntu 24.04 and Kali Linux rootfs environments with simulated root authority without unlocking or rooting your device.

No root permission or bootloader unlock required

Strict Sandboxing & Offline Privacy

All compile artifacts, database tables, and source files remain inside isolated application storage (/data/user/0/aurix.root.x/files). No code or telemetry is uploaded to external servers unless you explicitly sync with your private GitHub or Google Drive backups.

Module 02

Workspace & Project Management

RootX organizes your workflows into isolated project workspaces. You can initiate workspaces via the graphical user interface or automate generation using command-line shell utilities.

Method 1: Interactive GUI Wizard

01. Initiation

Tap the + Floating Action Button on the home dashboard.

02. Config

Provide project name, choose root directory, and pick initial template.

03. Launch

Tap Create to spawn the workspace folder and mount in the editor.

Method 2: Command-Line Generator

Generate project directories instantly from any active terminal shell session:

Workspace Scaffolding CLI

$ make project in -r <ProjectName>

# Common command aliases:

$ create project in -r <Name>

$ mk project in -r <Name>

Workspace Actions Reference

Action	Target Operation	Output / Destination
Open Project	Mounts workspace directory into the multi-tab editor	Editor Interface
Export as ZIP	Compresses project directory including assets	/storage/emulated/0/Download/
Push to GitHub	Synchronizes workspace with linked remote repository	git remote origin main
Delete Project	Permanently wipes workspace folder and local history	Irreversible Action

Module 03

Code Editor & Live Browser Preview

RootX features a desktop-grade code editor tailored for touchscreens and physical keyboards. It includes syntax lexers for 30+ languages, smart bracket pairing, auto-formatting, and an integrated sandboxed browser preview.

Multi-Language Syntax Highlighting

Optimized tokenizers for JavaScript, TypeScript, Python, HTML/CSS, Go, Kotlin, Java, PHP, C/C++, Rust, SQL, JSON, and Bash.

Intelligent Code Formatting

Instant formatting on save or shortcut with built-in Prettier rules for Web and Black/Autopep8 rules for Python scripts.

Real-Time Script & Web Preview Engine

Press Ctrl + P or tap the Play button in the editor toolbar. RootX starts an internal local server serving HTML/CSS/JS with a real-time console capture overlay capturing standard output, runtime exceptions, and network calls.

# Preview Port: localhost:8080 (or auto-assigned fallback)

Module 04

OTG & Bluetooth Keyboard Shortcuts

RootX supports desktop-grade key combinations with low latency over USB OTG adapters and Bluetooth keyboards.

Key Combination	Assigned Action	Context
`Ctrl + S`	Save active file to local disk	Code Editor
`Ctrl + P`	Launch Live Browser Preview / Script Run	Global
`Ctrl + T`	Toggle Terminal bottom drawer pane	Global
`Ctrl + M`	Toggle File Explorer drawer slider	Global
`Ctrl + F`	Format active code with Prettier / Black	Code Editor
`Ctrl + Shift + F`	Open global Search & Replace dialog	Code Editor
`Ctrl + N`	Create new file in active workspace	Code Editor
`Ctrl + W`	Close current editor tab	Code Editor
`Ctrl + R`	Run current file via default runtime	Code Editor

Safe Interrupt Pipeline (Non-Freezing Ctrl+C Architecture)

Unlike standard Android terminal wrappers that hard-kill background worker threads (causing database locks, corrupt socket descriptors, or frozen UI threads), RootX dispatches raw ASCII byte 0x03 directly into the native PTY stream. This triggers a graceful SIGINT inside Node, Python, and Linux processes.

Module 05

Dual Terminal Engines & Linux Distros

RootX provides dual terminal architectures to balance ultra-lightweight execution with complete desktop Linux environment capabilities.

Default Enginerx 12.0.6 E

Alpine Linux Subsystem

Lightweight Alpine 3.24 container (~3.5 MB rootfs) powered by apk. Optimized for ultra-fast startup, low RAM consumption, and instant Node.js/Python script execution.

$ distro switch alpine

Full Linux Enginerx v14 Linux

Ubuntu & Kali Linux RootFS

Full Ubuntu 24.04 LTS and official Kali Linux security container environments. Features complete apt package manager, systemd emulation, and simulated root privileges.

$ distro switch ubuntu # or: distro switch kali

Distribution Management CLI Reference

Linux Distribution Management Commands

# 1. View Installed Linux Distributions

$ distro list

$ distro show

# Output: Ubuntu 24.04 LTS (~70MB dl) | Alpine 3.24 (~3.5MB dl) | Kali Linux ARM64 (~110MB dl)

# 2. Switch Active Linux Distribution

$ distro switch ubuntu # Switch to Ubuntu 24.04 LTS

$ distro switch alpine # Switch to Alpine Linux 3.24

$ distro switch kali # Switch to Kali Linux security environment

# 3. Fresh Distribution Installation

$ install ubuntu # Download & deploy Ubuntu Server container

$ install alpine # Download & deploy Alpine Linux container

$ install kali # Deploy Kali Linux rootfs for pentest toolchains

# 4. Remove / Reset Container RootFS

$ distro delete ubuntu # Wipes Ubuntu container to reclaim storage

$ distro delete alpine # Wipes Alpine container

$ distro delete kali # Wipes Kali Linux container

# 5. Check Active Engine Status

$ update show

Module 06

Integrated Package Manager (`rx` / `pkg`)

RootX includes a dedicated native package manager. Install and link language runtimes without configuring complex build flags or environment paths manually.

Package	Runtime / Version	Installation CLI
Node.js	Node.js v22.0.0 & NPM v10.8.2	$ rx install nodejs
Python 3	Python 3.11+ Interpreter & PIP	$ rx install python
PHP	PHP 8.2 CLI Engine & Web Server	$ rx install php
Go (Golang)	Go v1.22.5 ARM64 Toolchain	$ rx install golang
Java & Kotlin	ECJ Compiler, Kotlinc & DexExecutor	$ rx install java
MariaDB (MySQL)	MariaDB 10.11 Server Daemon & Client	$ rx install mysql

Package Removal

Uninstall Syntax

$ rx uninstall nodejs

$ rx uninstall python

$ rx uninstall golang

$ rx uninstall mysql

Version Verification

Inspect Installed Versions

$ rx version nodejs

$ rx version npm

$ rx version python

$ rx version golang

Module 07

Shell Operations & Background Task Control

RootX provides a full POSIX-compliant shell environment. Standard utilities for file management, process handling, and background task management are pre-configured.

File System & Navigation Commands

POSIX Shell File System Commands

$ ls # List directory contents

$ cd [path] # Change directory (cd ~ for home, cd .. for parent)

$ pwd # Print current working directory path

$ mkdir <directory> # Create new folder directory

$ rm <file_or_dir> # Delete file/directory recursively

$ cat <file> # Display text contents of target file

$ touch <file> # Create empty file or update timestamp

$ cp <src> <dest> # Copy file or directory

$ mv <src> <dest> # Move or rename file

$ clear # Clear terminal screen buffer

$ history # Display command execution history

$ about # Print RootX system version & kernel architecture

Direct Script Execution

Language Script Execution

# JavaScript & Node.js

$ node index.js # Run JS file via Node.js v22

$ npm install express # Install npm dependencies

$ npx vite # Run Vite local dev server

# Python

$ python main.py # Run Python script

$ pip install requests # Install PyPI packages

# Go Toolchain

$ go run main.go # Compile and execute Go source in memory

$ go build # Produce standalone ARM64 Linux binary

# Java & Kotlin JVM Execution

$ java Main.java # Compiles with ECJ, converts to dex & runs

$ kt App.kt # Compiles with kotlinc & executes on JVM

Background Server & PID Task Control

When servers run in background threads (such as Vite, Express, or Django), manage them using the built-in rx task manager:

Process Manager & Port Watcher

# 1. List active background servers, listening ports & Process IDs (PIDs)

$ rx task

# 2. Terminate specific server by PID

$ rx task -<PID> kill

# Example:

$ rx task -4532 kill

# 3. Kill all active background servers simultaneously

$ rx task all kill

Instant Storage Navigation Flags

$ rx -iSwitch immediately to ultra-fast Internal App Storage (/data/user/0/...)

$ rx ~sdcardSwitch to External Device Storage (/sdcard/ or Download folder)

Module 08

AppSettings Parameters & Visual Themes

RootX exposes fine-grained customization parameters stored in persistent app state. Fine-tune your typography, indentation, and AI companion endpoints.

AppSettings Configuration Matrix

Parameter Key	Default Value	Description
themeName	"ONE_DARK"	Active syntax highlighting color scheme for editor
appTheme	"Aurix UI"	Application layout theme (AMOLED Dark vs Glass UI)
fontSize	14	Editor font size (adjustable between 8sp and 32sp)
tabSize	4	Indentation spaces count (2, 4, or 8)
autoFormatOnSave	true	Automatically formats code on file save
autoCloseBrackets	true	Auto-pairs brackets (), [], and quote marks
selectedAiModel	"gpt-4o-mini"	Connected OpenRouter AI model for assistance

Supported Syntax Color Themes (11 Handcrafted Palettes)

One Dark

Dracula

Monokai

GitHub Dark

Material Theme

Nord

Tokyo Night

Aurix Black

Neon Vibe

Cyberpunk

Oceanic Next

OpenRouter AI Companion Integration

Insert your custom OpenRouter API token in Settings > AI Configuration to unlock multi-model switching between Claude 3.5 Sonnet, GPT-4o, Gemini 1.5 Pro, and open-source Llama 3 models for automated bug fixing and code generation.

Module 09

System Diagnostics & Troubleshooting

Engineered step-by-step diagnostic procedures for common edge cases, port collisions, and Android sandbox limitations.

DIAGNOSTIC CASE #01Glibc Compatibility

"Command not found" when running complex NPM, Pip, or native C++ modules

Underlying Cause: The standard standalone Android shell relies on Bionic libc instead of GNU C Library (glibc). Complex binaries compiled for standard Linux fail to resolve dynamic linker bindings.

Resolution Steps:

1. Switch to PRoot Linux environment: v14 linux

2. Launch or install Ubuntu rootfs: install ubuntu or distro switch ubuntu

3. Run packages inside the glibc container via standard apt install python3-pip.

DIAGNOSTIC CASE #02Port Collisions

Port blocked ("EADDRINUSE: address already in use") or background server hangs

Underlying Cause: Vite, Express, or Django servers started in previous terminal tabs keep TCP sockets bound in background daemon threads.

Resolution Steps:

1. List listening sockets & PIDs: $ rx task

2. Terminate the blocking PID: $ rx task -<PID> kill

3. Or flush all listening daemon servers: $ rx task all kill

DIAGNOSTIC CASE #03

Permission Denied on SD Card path (/storage/emulated/0)

Android 11+ Scoped Storage restricts write access to root external storage.

Run: $ rx -i to operate in unrestricted high-performance internal app storage.

DIAGNOSTIC CASE #04

Terminal UI crash during intense compile loops

Main looper threads can choke if continuous stdout writes occur without throttling.

RootX deploys an asynchronous ring buffer batching terminal updates every 16ms (60 FPS sync).

Support Desk Privacy Policy Terms of Service