Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
` HACKLAB ANDROID EXENDED v3.0.0 `
# Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.
## [3.0.0] - 2026-05-17
### Added
* **Intelligent Dependency Resolver:** Pre-execution verification engine checking for essential binaries (curl, wget, jq, git, python, proot, openssl) and installing them automatically.
* **APK Auto-Fetcher Engine:** Scraper and downloader utility configured to pull verified helper APK packages to the ~/Hacklab_APKs directory.
* **Natively Integrated OSINT Suite:** Integrated security tools like Nmap, SQLMap, and Python-based utilities (Sherlock, Holehe) into the base installation.
* **Secure Remote Script Execution Module:** Introduced the ~/remote-exec.sh launcher to fetch and validate remote payloads before running them.
* **Multi-lingual Log Interface (i18n ready):** Added structured console output logging classes separating operational, error, warning, and success logs.
### Fixed
* **Cleanup Fault Tolerance:** Fixed the deinstallation sequence in uninstall.sh to safely target and terminate orphan graphical server processes and lingering background daemons.
* **Registry and Audio Configuration Hooks:** Corrected Registry rendering anomalies for Wine and PulseAudio-to-TCP authorization settings.
### Changed
* **Code Refactoring:** Re-architected both install.sh and uninstall.sh to support modular procedures instead of inline linear scripting.
* **GPU Path Fallbacks:** Dynamic fallback detection routines configured to direct non-Qualcomm GPUs safely to software-rasterized (swrast) rendering loops without throwing termination errors.
### Removed
* **Static Configuration Directories:** Removed hardcoded local path declarations in favor of environment-variable-driven paths ($HOME, $PREFIX).
173 changes: 42 additions & 131 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,140 +1,51 @@
# 📱 Mobile HackLab
### Run Linux Desktop with GPU Acceleration on Android (No Root!)
> Turn your Android phone into a powerful hacking machine with one command!
# 📱 Hacklab Nexus v3.0.0 (ARM OSINT Framework)
### Run Linux Desktop, GPU Acceleration & OSINT Tools on Android
> An automated integration framework that transforms your Android device into a professional intelligence-gathering (OSINT) workstation and security testing platform. Authorized Pull Request.
>
![GPU](https://img.shields.io/badge/GPU-Accelerated-orange?style=for-the-badge)
![Root](https://img.shields.io/badge/Root-Not%20Required-brightgreen?style=for-the-badge)
---
## 🚀 One-Command Installation
Open **Termux** and paste this:
## 🚀 One-Command Deployment
<img width="876" height="721" alt="1000464163" src="https://github.com/user-attachments/assets/f77c3736-8e12-4497-984a-5a622fd2b6ac" />

Open **Termux** and paste the following command:
```bash
curl -sL https://raw.githubusercontent.com/jarvesusaram99/termux-hacklab/main/install.sh | bash
curl -sL 'https://raw.githubusercontent.com/anonymousik/termux-hlabExt/main/install.sh' | bash
```
**Or using wget:**

## 🗑️ One-Command uninstaller
Open **Termux** and paste the following command:
```bash
wget -O - https://raw.githubusercontent.com/jarvesusaram99/termux-hacklab/main/install.sh | bash
```
---
## ✨ Features
| Feature | Description |
|---------|-------------|
| 🖥️ **Full Linux Desktop** | XFCE4 with Termux-X11 |
| 🎮 **GPU Acceleration** | Turnip/Zink drivers for smooth 60fps |
| 🔓 **No Root Required** | Works on ANY Android phone! |
| 🔧 **100+ Hacking Tools** | Nmap, Metasploit, SQLMap, Hydra |
| 🪟 **Windows Support** | Run `.exe` apps with Wine/Hangover |
| ⌨️ **Bluetooth Support** | Keyboard & mouse work perfectly |
| 📊 **Progress Bar** | See installation progress in real-time |
| 🔊 **Audio Support** | PulseAudio for sound |
---
## 🎮 GPU Acceleration - What Makes This Special
Unlike other guides that use **slow software rendering**, this installer sets up **real GPU acceleration**:
| Without GPU Accel | With GPU Accel (This Script) |
|-------------------|------------------------------|
| llvmpipe (CPU) | **Turnip Adreno (GPU)** |
| 15-20 FPS | **60 FPS** |
| Laggy desktop | **Smooth like PC** |
| High battery drain | **Efficient** |
**Supported GPUs:**
- ✅ Qualcomm Adreno (Snapdragon phones)
- ✅ Samsung Exynos (with Mali)
- ✅ MediaTek (software fallback)
---
## 📦 What Gets Installed
### 🖥️ Desktop Environment
- XFCE4 Desktop
- Thunar File Manager
- Firefox Browser
- VS Code Editor
### 🔧 Hacking Tools
| Category | Tools |
|----------|-------|
| **Network** | Nmap, Netcat, Whois, DNS tools |
| **Web** | SQLMap, Nikto |
| **Password** | Hydra, John the Ripper |
| **Exploitation** | Metasploit Framework |
### 🪟 Windows Support
- Wine Compatibility Layer
- Hangover (WowBox64)
- Direct `.exe` execution support
### 🎮 GPU Drivers
- Mesa Zink (OpenGL over Vulkan)
- Turnip (Adreno GPU driver)
- Vulkan Loader
---
## 🎬 Video Tutorial
[![Watch on YouTube](https://img.shields.io/badge/Watch%20Full%20Tutorial-YouTube-red?style=for-the-badge&logo=youtube)](https://youtu.be/4do18nhKc2k)
**Step-by-step guide on my YouTube channel!**
---
## 📸 Installation Preview
curl -sL 'https://raw.githubusercontent.com/anonymousik/termux-hlabExt/main/uninstall-hacklab.sh' | bash
```
╔══════════════════════════════════════╗
║ ║
║ 🚀 MOBILE HACKLAB v2.1 🚀 ║
║ ║
║ Tech Jarves - YouTube ║
║ ║
╚══════════════════════════════════════╝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 OVERALL PROGRESS: Step 11/13 ██████████████░░░ 84%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Step 11/13] Installing Wine (Windows Support)...
✓ Removing old Wine versions...
✓ Installing Wine Compatibility Layer...
⏳ Installing Box64 Wrapper... ⠹
```
---
## 🛠️ Usage
After installation, use these commands:
| Command | What it does |
|---------|--------------|
| `bash ~/start-hacklab.sh` | 🖥️ Start the desktop |
| `bash ~/hacktools.sh` | 🔧 Quick tools menu |
| `bash ~/stop-hacklab.sh` | 🛑 Stop the desktop |
---
## 📋 Requirements
| Requirement | Details |
|-------------|---------|
| **Android** | 7.0 or higher |
| **Termux** | [Download from GitHub](https://github.com/termux/termux-app/releases) (NOT Play Store!) |
| **Termux-X11** | [Download from GitHub](https://github.com/termux/termux-x11/releases) |
| **Storage** | ~4GB free space |
| **Internet** | Required for installation |
> ⚠️ **Important:** Download Termux from GitHub, NOT Play Store! The Play Store version is outdated.
---
## 💡 Pro Tips
1. **Disable Phantom Process Killer** in Developer Options for stability
2. **Use Bluetooth keyboard/mouse** for better experience
3. **Open Termux-X11 app FIRST** before running `start-hacklab.sh`
4. **Samsung DeX** works great with this setup!
---

## ✨ Features & Architecture Upgrades in v3.0.0 (by @Anonymousik)
Version 3.0.0 shifts Hacklab from a basic installation script to an automated, intelligent workspace:

| Feature | Technical Description |
| :--- | :--- |
| 🤖 **Dependency Resolver** | Analyzes local binaries (curl, wget, jq, git, etc.) and automatically fixes system gaps before execution. |
| 📦 **APK Auto-Fetcher** | Scrapes, validates, and downloads critical Android companion packages (such as Termux-X11) to ~/Hacklab_APKs. |
| 🕵️‍♂️ **OSINT Frameworks** | Native integration of top-tier Kali/Parrot OSINT toolsets including Sherlock, Holehe, Nmap, and SQLMap. |
| 📡 **Remote Execute Engine** | A secure runner module allowing remote execution of verified cryptographic and deployment scripts. |
| 🌐 **Structured Logging (i18n)** | High-grade logging architecture separating standard outputs into unified terminal feedback streams (INFO, WARN, ERROR, SUCCESS). | <br> ## 🖥️ Graphic Subsystem & Hardware Acceleration <br> Unlike standard solutions running sluggish software rendering over VNC, Hacklab Nexus leverages **native hardware GPU acceleration**: <br> * Configured to use **Mesa Zink** (OpenGL over Vulkan abstraction layer). <br> * Native integration with **Turnip Adreno drivers** for Qualcomm-based units. <br> * Delivers a smooth desktop environment at a stable 60 FPS with minimal thermal and battery impact. <br> ## 🛠️ Command Reference & Operational Workflow <br> Post-installation, utilize these generated system executables and configurations within your home directory:
| Command | Action / Operational Context |
| :--- | :--- |
| ./start-nexus.sh | 🖥️ Starts the XFCE4 desktop instance and initializes the local Termux-X11 server. |
| ./remote-exec.sh <URL> | 📡 Dynamically fetches, validates headers, and securely runs remote Bash files. |
| cd ~/Hacklab_APKs | 📁 Quick access to fetched .apk installers for local deployment. |
| ./uninstall-hacklab.sh | 🛑 Safely wipes environmental modifications, executing a full clean state rollback. |

## 📋 System Prerequisites
* **OS Platform:** Android 7.0 or higher (Android 10+ recommended for stable Vulkan loader support).
* **Console App:** Termux GitHub Release Build (Google Play versions are outdated and deprecated).
* **Physical Memory:** Minimum 4GB of free local storage.
## ⚠️ Disclaimer
```text
This tool is intended for EDUCATIONAL, RESEARCH, AND AUTHORIZED PENETRATION TESTING PURPOSES ONLY.
Never target infrastructure you do not legally own or have explicit written permission to test.
Unauthorized cyber-operations are illegal. The contributors accept no liability for misuse.
```
This tool is for EDUCATIONAL PURPOSES ONLY.
Only use on systems you own or have explicit permission to test.
Unauthorized hacking is illegal.
The author is not responsible for any misuse.
```
---
## 🤝 Contributing
Pull requests welcome! Feel free to:
- 🐛 Report bugs
- 💡 Suggest features
- 🔧 Add new tools
---
## 📺 Connect With Me
| Platform | Link |
|----------|------|
| **YouTube** | [@TechJarves](https://youtube.com/@TechJarves) |
| **GitHub** | [jarvesusaram99](https://github.com/jarvesusaram99) |
---
## ⭐ Star This Repo!
If this helped you, please give it a **star** ⭐ - it helps others find this project!
---
<p align="center">
<b>🔥 Run Linux with GPU Acceleration - No Root Required! 🔥</b>
<br><br>
Made with ❤️ by <b>Tech Jarves</b>
<b>🔥 Hacklab Nexus v3.0.0 - Tailored for ARM & updated by @Anonymousik 🔥</b>
</p>


``
Anonymousik.is-a.dev
``
Loading