From 6cadf5f82ee282f3c229e43959765dc572b5dca3 Mon Sep 17 00:00:00 2001 From: Sanjana Date: Thu, 23 Oct 2025 17:16:17 +0530 Subject: [PATCH 1/6] docs: transformed README into a visual, picture-book style cyber guide Revamped the README with new visuals, OS logos, GIFs, and improved installation sections. Made it more user-friendly, organised, and visually engaging for beginners. --- README.md | 237 +++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 183 insertions(+), 54 deletions(-) diff --git a/README.md b/README.md index 8573bed..187aa59 100644 --- a/README.md +++ b/README.md @@ -1,61 +1,190 @@ -# Kali-Linux-for-Android -Transform your Android device into a cybersecurity playground with Kali Magic! πŸš€ -# KaliMagic πŸŽ©πŸ” - -Discover the cybersecurity playground with Kali Magic! πŸš€ -# installation -simply tap below or visit [LinuxnDroid](https://github.com/AryanVBW/LinuxDroid) and transform your Android device into a Linux powerhouse effortlessly! πŸš€πŸ’»πŸ“± -

- -Darkside

- -## 🌟 Key Features: - -- **Powerful Tools:** Unleash penetration testing tools for a comprehensive security testing experience. - -- **Mobile Optimization:** Tailored specifically for Android devices, ensuring seamless integration and performance. - -## Notable Tools Included: -- Nmap -- Wireshark -- Metasploit -- Burp Suite -- Aircrack-ng -- Hydra -- John the Ripper -- SQLMap -- LibreOffice -- Visual Studio Code -- Mozilla Firefox - -Dive into the world of cybersecurity on your Android! -

For manually installation of and Linux follow the following

-

- - -

-

Copy it for Kali Linux /NetHunter Rootless Edition:

- -```bash +# Kali-Linux-for-Android β€” Kali Magic πŸŽ©πŸ” + +> Transform your Android device into a **portable cybersecurity playground** β€” run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). πŸš€πŸ’»πŸ“± + +[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) +[![Releases](https://img.shields.io/github/v/release/AryanVBW/ParrotSecurityOsForAndroid)](https://github.com/AryanVBW/ParrotSecurityOsForAndroid/releases) +[![Downloads](https://img.shields.io/github/downloads/AryanVBW/ParrotSecurityOsForAndroid/total)]() + +--- + +> **Before you paste (optional but recommended):** +> Create `assets/gifs/` and add demo GIFs & logos so README images load reliably. Example: +> +> ```bash +> mkdir -p assets/gifs +> wget -O assets/gifs/nmap-scan.gif "https://upload.wikimedia.org/wikipedia/commons/3/3b/Terminal_demo.gif" +> wget -O assets/gifs/metasploit-demo.gif "https://upload.wikimedia.org/wikipedia/commons/5/5f/Metasploit_Console.gif" +> wget -O assets/gifs/wireshark-capture.gif "https://upload.wikimedia.org/wikipedia/commons/6/6d/Wireshark_capture.gif" +> wget -O assets/gifs/linuxdroid-install.gif "https://upload.wikimedia.org/wikipedia/commons/1/1a/Installer_demo.gif" +> wget -O assets/gifs/kali-logo.png "https://upload.wikimedia.org/wikipedia/commons/2/2b/Kali-dragon-icon.png" +> wget -O assets/gifs/parrot-logo.png "https://upload.wikimedia.org/wikipedia/commons/8/8b/Parrot-logo.png" +> wget -O assets/gifs/ubuntu-logo.png "https://upload.wikimedia.org/wikipedia/commons/a/ab/Logo-ubuntu_cof-orange-hex.svg" +> wget -O assets/gifs/debian-logo.png "https://upload.wikimedia.org/wikipedia/commons/0/0d/Debian-logo.svg" +> git add assets/gifs/* +> git commit -m "Add README demo assets" +> git push origin main +> ``` + +--- + +## πŸ“– Table of Contents + +- [About](#about) +- [Supported Operating Systems](#supported-operating-systems) +- [Features](#features) +- [Prerequisites](#prerequisites) +- [Quick Install](#quick-install) +- [Manual Installation](#manual-installation) +- [Kali NetHunter (Rootless)](#kali-nethunter-rootless) +- [Visual Demos](#visual-demos) + - [Nmap](#nmap) + - [Metasploit](#metasploit) + - [Wireshark](#wireshark) + - [Installer Walkthrough](#installer-walkthrough) +- [Usage Examples](#usage-examples) +- [Installation Link](#installation-link) +- [Security & Legal Notice](#security--legal-notice) +- [Contributing & Support](#contributing--support) +- [Credits & License](#credits--license) + +--- + +## 🧠 About + +**Kali Magic** lets you experience **Kali Linux / Parrot OS / NetHunter** tools right on Android β€” perfect for **students, researchers, and ethical hackers** learning on the go. + +Run full penetration-testing environments inside **Termux + LinuxDroid**. +It’s portable, rootless, and visually documented with live demos. + +[![Visit LinuxDroid](assets/gifs/linuxdroid-install.gif)](https://github.com/AryanVBW/LinuxDroid) + +--- + +## 🐧 Supported Operating Systems + +| OS | Version | Description | Logo | +|----|---------|-------------|------| +| **Kali Linux** | Rolling | Advanced penetration testing & security distro. | ![Kali Logo](assets/gifs/kali-logo.png) | +| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy & dev tools. | ![Parrot Logo](assets/gifs/parrot-logo.png) | +| **Ubuntu** | 20.04+ | General-purpose Linux for dev & scripting. | ![Ubuntu Logo](assets/gifs/ubuntu-logo.png) | +| **Debian** | 11+ | Stable, server-ready Linux distribution. | ![Debian Logo](assets/gifs/debian-logo.png) | + +--- + +## 🌟 Features + +- Mobile-optimized environment for Kali / NetHunter tools. +- Run powerful pentest tools inside Termux/proot (rootless). +- Quick installer + visual setup walkthrough. +- Lightweight GIF demos and prebuilt commands. +- Safe for educational / ethical security labs. + +--- + +## βš™οΈ Prerequisites + +- Android 7.0+ +- Termux (from F-Droid) +- `termux-setup-storage` permission granted +- Disk: ~3-8 GB free space +- (Optional) Root access for Wi-Fi injection or OTG tools + +> πŸ’‘ Always inspect scripts before running: +> ```bash +> cat install.sh +> ``` + +--- + +## πŸš€ Quick Install + +```bash +pkg update && pkg upgrade -y +pkg install wget curl proot -y + +# Download & run Kali NetHunter installer wget -O install-nethunter-termux https://offs.ec/2MceZWr - chmod +x install-nethunter-termux - ./install-nethunter-termux +chmod +x install-nethunter-termux +./install-nethunter-termux + +# Optional extras (LinuxDroid) wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh && chmod +x menu.sh -rm .bashrc && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -mv default.bashrc .bashrc - ``` -Kali NetHunter is the ultimate mobile penetration testing platform. It's based on Kali Linux, the most popular penetration testing distribution, and it allows you to run a full range of security tools on your Android device. -With Kali NetHunter, you can: +# Optional bash presets +cp ~/.bashrc ~/.bashrc.backup || true +wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -O ~/.bashrc + +# Start GUI +nethunter kex & +./menu.sh + +pkg install proot-distro +proot-distro list +proot-distro install debian +proot-distro login debian + +# Inside Debian +apt update && apt upgrade -y +apt install kali-tools-top10 -y +wget -O install-nethunter-termux https://offs.ec/2MceZWr +chmod +x install-nethunter-termux +./install-nethunter-termux +nethunter kex & +nmap -A 192.168.1.1/24 +msfconsole +use exploit/android/browser/webview_addjavascriptinterface +# List installed tools +ls /usr/share/ + +# Start Metasploit +msfconsole + +# Network Scan +nmap -sS 192.168.1.0/24 +mkdir -p scripts +cat > scripts/optimize_gifs.sh <<'EOF' +#!/usr/bin/env bash +# optimize_gifs.sh +# Example: ./optimize_gifs.sh 640 15 + +set -e +MAX_WIDTH="${1:-640}" +FPS="${2:-15}" +SRC_DIR="assets/gifs" +OUT_DIR="${SRC_DIR}/optimized" + +mkdir -p "$OUT_DIR" + +if ! command -v ffmpeg >/dev/null 2>&1; then + pkg install -y ffmpeg || apt install -y ffmpeg +fi + +if ! command -v gifsicle >/dev/null 2>&1; then + pkg install -y gifsicle || apt install -y gifsicle || true +fi + +for gif in "$SRC_DIR"/*.gif; do + fname="$(basename "$gif")" + tmp="${OUT_DIR}/tmp-${fname}" + out="${OUT_DIR}/${fname%.*}-opt.gif" -* Penetration test Android devices -* Perform security research -* Learn about ethical hacking + ffmpeg -y -i "$gif" -vf "scale='min(${MAX_WIDTH},iw)':'-2',fps=${FPS}" "$tmp" + if command -v gifsicle >/dev/null 2>&1; then + gifsicle -O3 "$tmp" -o "$out" + else + mv "$tmp" "$out" + fi + echo "Optimized: $out" +done +EOF -Kali NetHunter is easy to install and use. Just follow the instructions in this guide and you'll be up and running in minutes. -## 🀝 Contribution and Support: +chmod +x scripts/optimize_gifs.sh +./scripts/optimize_gifs.sh 640 15 +git add assets/gifs/optimized/* +git commit -m "Add optimized README GIFs" +git push origin main -- Contribute by reporting issues, suggesting enhancements, or submitting pull requests. -- Join the KaliMagic community on our dedicated forums. +--- + -Explore the power of Kali Linux on your Android device! πŸ’»πŸ“± #KaliMagic #AndroidSecurity From 88211571614c3f0462219d56ac58d92393df09f2 Mon Sep 17 00:00:00 2001 From: Sanjana Date: Thu, 23 Oct 2025 23:53:13 +0530 Subject: [PATCH 2/6] Update README.md --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index 187aa59..85a0bc6 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,6 @@ --- -> **Before you paste (optional but recommended):** -> Create `assets/gifs/` and add demo GIFs & logos so README images load reliably. Example: -> > ```bash > mkdir -p assets/gifs > wget -O assets/gifs/nmap-scan.gif "https://upload.wikimedia.org/wikipedia/commons/3/3b/Terminal_demo.gif" From c7c71f9f218dbe2288572c20aef058265f92781f Mon Sep 17 00:00:00 2001 From: Sanjana Date: Sat, 18 Jul 2026 23:48:08 +0530 Subject: [PATCH 3/6] fix(docs): address PR review feedback for README guide Resolve broken badges, missing TOC sections, and absent logo assets. Split Quick Install into clear Option A/B paths and extract the GIF optimizer into scripts/optimize_gifs.sh. --- README.md | 310 +++++++++++++++++++++++------------- assets/gifs/debian-logo.svg | 86 ++++++++++ assets/gifs/kali-logo.svg | 1 + assets/gifs/parrot-logo.svg | 1 + assets/gifs/ubuntu-logo.svg | 1 + scripts/optimize_gifs.sh | 40 +++++ 6 files changed, 326 insertions(+), 113 deletions(-) create mode 100644 assets/gifs/debian-logo.svg create mode 100644 assets/gifs/kali-logo.svg create mode 100644 assets/gifs/parrot-logo.svg create mode 100644 assets/gifs/ubuntu-logo.svg create mode 100755 scripts/optimize_gifs.sh diff --git a/README.md b/README.md index 85a0bc6..8053374 100644 --- a/README.md +++ b/README.md @@ -1,60 +1,46 @@ # Kali-Linux-for-Android β€” Kali Magic πŸŽ©πŸ” -> Transform your Android device into a **portable cybersecurity playground** β€” run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). πŸš€πŸ’»πŸ“± +> Transform your Android device into a **portable cybersecurity playground** β€” run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) -[![Releases](https://img.shields.io/github/v/release/AryanVBW/ParrotSecurityOsForAndroid)](https://github.com/AryanVBW/ParrotSecurityOsForAndroid/releases) -[![Downloads](https://img.shields.io/github/downloads/AryanVBW/ParrotSecurityOsForAndroid/total)]() +[![Releases](https://img.shields.io/github/v/release/AryanVBW/Kali-Linux-for-Android)](https://github.com/AryanVBW/Kali-Linux-for-Android/releases) +[![Downloads](https://img.shields.io/github/downloads/AryanVBW/Kali-Linux-for-Android/total)](https://github.com/AryanVBW/Kali-Linux-for-Android/releases) ---- - -> ```bash -> mkdir -p assets/gifs -> wget -O assets/gifs/nmap-scan.gif "https://upload.wikimedia.org/wikipedia/commons/3/3b/Terminal_demo.gif" -> wget -O assets/gifs/metasploit-demo.gif "https://upload.wikimedia.org/wikipedia/commons/5/5f/Metasploit_Console.gif" -> wget -O assets/gifs/wireshark-capture.gif "https://upload.wikimedia.org/wikipedia/commons/6/6d/Wireshark_capture.gif" -> wget -O assets/gifs/linuxdroid-install.gif "https://upload.wikimedia.org/wikipedia/commons/1/1a/Installer_demo.gif" -> wget -O assets/gifs/kali-logo.png "https://upload.wikimedia.org/wikipedia/commons/2/2b/Kali-dragon-icon.png" -> wget -O assets/gifs/parrot-logo.png "https://upload.wikimedia.org/wikipedia/commons/8/8b/Parrot-logo.png" -> wget -O assets/gifs/ubuntu-logo.png "https://upload.wikimedia.org/wikipedia/commons/a/ab/Logo-ubuntu_cof-orange-hex.svg" -> wget -O assets/gifs/debian-logo.png "https://upload.wikimedia.org/wikipedia/commons/0/0d/Debian-logo.svg" -> git add assets/gifs/* -> git commit -m "Add README demo assets" -> git push origin main -> ``` +

+ + Visit LinuxDroid + +

--- ## πŸ“– Table of Contents -- [About](#about) -- [Supported Operating Systems](#supported-operating-systems) -- [Features](#features) -- [Prerequisites](#prerequisites) -- [Quick Install](#quick-install) -- [Manual Installation](#manual-installation) -- [Kali NetHunter (Rootless)](#kali-nethunter-rootless) -- [Visual Demos](#visual-demos) - - [Nmap](#nmap) - - [Metasploit](#metasploit) - - [Wireshark](#wireshark) - - [Installer Walkthrough](#installer-walkthrough) -- [Usage Examples](#usage-examples) -- [Installation Link](#installation-link) -- [Security & Legal Notice](#security--legal-notice) -- [Contributing & Support](#contributing--support) -- [Credits & License](#credits--license) +- [About](#about) +- [Supported Operating Systems](#supported-operating-systems) +- [Features](#features) +- [Prerequisites](#prerequisites) +- [Quick Install](#quick-install) +- [Manual Installation](#manual-installation) +- [Kali NetHunter (Rootless)](#kali-nethunter-rootless) +- [Visual Demos](#visual-demos) + - [Nmap](#nmap) + - [Metasploit](#metasploit) + - [Wireshark](#wireshark) + - [Installer Walkthrough](#installer-walkthrough) +- [Usage Examples](#usage-examples) +- [Installation Link](#installation-link) +- [Security and Legal Notice](#security-and-legal-notice) +- [Contributing and Support](#contributing-and-support) +- [Credits and License](#credits-and-license) --- ## 🧠 About -**Kali Magic** lets you experience **Kali Linux / Parrot OS / NetHunter** tools right on Android β€” perfect for **students, researchers, and ethical hackers** learning on the go. - -Run full penetration-testing environments inside **Termux + LinuxDroid**. -It’s portable, rootless, and visually documented with live demos. +**Kali Magic** lets you experience **Kali Linux / Parrot OS / NetHunter** tools right on Android β€” perfect for **students, researchers, and ethical hackers** learning on the go. -[![Visit LinuxDroid](assets/gifs/linuxdroid-install.gif)](https://github.com/AryanVBW/LinuxDroid) +Run full penetration-testing environments inside **Termux + LinuxDroid**. It is portable, rootless, and documented with clear install paths and usage examples. --- @@ -62,126 +48,224 @@ It’s portable, rootless, and visually documented with live demos. | OS | Version | Description | Logo | |----|---------|-------------|------| -| **Kali Linux** | Rolling | Advanced penetration testing & security distro. | ![Kali Logo](assets/gifs/kali-logo.png) | -| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy & dev tools. | ![Parrot Logo](assets/gifs/parrot-logo.png) | -| **Ubuntu** | 20.04+ | General-purpose Linux for dev & scripting. | ![Ubuntu Logo](assets/gifs/ubuntu-logo.png) | -| **Debian** | 11+ | Stable, server-ready Linux distribution. | ![Debian Logo](assets/gifs/debian-logo.png) | +| **Kali Linux** | Rolling | Advanced penetration testing and security distro. | Kali Logo | +| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy, and developer tools. | Parrot Logo | +| **Ubuntu** | 20.04+ | General-purpose Linux for development and scripting. | Ubuntu Logo | +| **Debian** | 11+ | Stable, server-ready Linux distribution. | Debian Logo | --- ## 🌟 Features -- Mobile-optimized environment for Kali / NetHunter tools. -- Run powerful pentest tools inside Termux/proot (rootless). -- Quick installer + visual setup walkthrough. -- Lightweight GIF demos and prebuilt commands. -- Safe for educational / ethical security labs. +- Mobile-optimized environment for Kali / NetHunter tools +- Run powerful pentest tools inside Termux / proot (rootless) +- Quick installer with two clear install paths +- Copy-paste-ready commands for common tools +- Safe for educational and ethical security labs --- ## βš™οΈ Prerequisites -- Android 7.0+ -- Termux (from F-Droid) -- `termux-setup-storage` permission granted -- Disk: ~3-8 GB free space -- (Optional) Root access for Wi-Fi injection or OTG tools +- Android 7.0+ +- [Termux](https://f-droid.org/packages/com.termux/) (from F-Droid) +- `termux-setup-storage` permission granted +- Disk: ~3–8 GB free space +- (Optional) Root access for Wi-Fi injection or OTG tools -> πŸ’‘ Always inspect scripts before running: +> Always inspect scripts before running: > ```bash -> cat install.sh +> cat install-nethunter-termux > ``` --- ## πŸš€ Quick Install +Choose **one** path below β€” do not run both. + +### Option A: Direct Termux (NetHunter Rootless) + +Best for a quick Kali NetHunter rootless setup inside Termux. + ```bash pkg update && pkg upgrade -y pkg install wget curl proot -y -# Download & run Kali NetHunter installer +# Download and run Kali NetHunter installer wget -O install-nethunter-termux https://offs.ec/2MceZWr chmod +x install-nethunter-termux ./install-nethunter-termux -# Optional extras (LinuxDroid) -wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh && chmod +x menu.sh +# Optional: LinuxDroid menu helpers +wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh +chmod +x menu.sh -# Optional bash presets -cp ~/.bashrc ~/.bashrc.backup || true +# Optional: bash presets +cp ~/.bashrc ~/.bashrc.backup 2>/dev/null || true wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -O ~/.bashrc -# Start GUI +# Start GUI (after install completes) nethunter kex & ./menu.sh +``` + +### Option B: Debian via proot-distro + +Best if you want a full Debian container, then install Kali tools inside it. + +```bash +pkg update && pkg upgrade -y +pkg install wget curl proot-distro -y -pkg install proot-distro proot-distro list proot-distro install debian proot-distro login debian +``` -# Inside Debian +Inside the Debian container: + +```bash apt update && apt upgrade -y apt install kali-tools-top10 -y + +# Optional: NetHunter-style tooling inside the container wget -O install-nethunter-termux https://offs.ec/2MceZWr chmod +x install-nethunter-termux ./install-nethunter-termux -nethunter kex & -nmap -A 192.168.1.1/24 +``` + +--- + +## πŸ› οΈ Manual Installation + +1. Install Termux from F-Droid (not Play Store). +2. Open Termux and grant storage access: + ```bash + termux-setup-storage + ``` +3. Follow **Option A** or **Option B** in [Quick Install](#quick-install). +4. For a multi-distro Android Linux experience, use [LinuxDroid](https://github.com/AryanVBW/LinuxDroid). + +--- + +## πŸ‰ Kali NetHunter (Rootless) + +Kali NetHunter Rootless runs on stock, unrooted Android via Termux. It is based on Kali Linux and provides a mobile penetration-testing platform for learning and research. + +With NetHunter Rootless you can: + +- Practice ethical hacking and security research on Android +- Use common Kali tools in a portable environment +- Learn without requiring a rooted device + +After installation: + +```bash +nethunter # enter NetHunter CLI +nethunter kex & # start KeX GUI session (if configured) +``` + +Official guide: [Kali NetHunter Rootless](https://www.kali.org/docs/nethunter/nethunter-rootless/) + +--- + +## 🎬 Visual Demos + +### Nmap + +Scan a local subnet (replace with a network you own or have permission to test): + +```bash +nmap -sS 192.168.1.0/24 +nmap -A 192.168.1.1 +``` + +### Metasploit + +```bash msfconsole -use exploit/android/browser/webview_addjavascriptinterface -# List installed tools +``` + +### Wireshark + +On devices with GUI / KeX support: + +```bash +wireshark +# or capture from CLI +tshark -i any -c 50 +``` + +### Installer Walkthrough + +1. Update Termux packages +2. Run the NetHunter installer (**Option A**) or set up Debian (**Option B**) +3. Launch `nethunter` / `menu.sh` +4. Install tools as needed (`nmap`, `metasploit-framework`, etc.) + +

+ + Installer walkthrough + +

+ +--- + +## πŸ’‘ Usage Examples + +```bash +# List tools (Debian / Kali container) ls /usr/share/ +# Network discovery (authorized networks only) +nmap -sn 192.168.1.0/24 + # Start Metasploit msfconsole -# Network Scan -nmap -sS 192.168.1.0/24 -mkdir -p scripts -cat > scripts/optimize_gifs.sh <<'EOF' -#!/usr/bin/env bash -# optimize_gifs.sh -# Example: ./optimize_gifs.sh 640 15 - -set -e -MAX_WIDTH="${1:-640}" -FPS="${2:-15}" -SRC_DIR="assets/gifs" -OUT_DIR="${SRC_DIR}/optimized" - -mkdir -p "$OUT_DIR" - -if ! command -v ffmpeg >/dev/null 2>&1; then - pkg install -y ffmpeg || apt install -y ffmpeg -fi - -if ! command -v gifsicle >/dev/null 2>&1; then - pkg install -y gifsicle || apt install -y gifsicle || true -fi - -for gif in "$SRC_DIR"/*.gif; do - fname="$(basename "$gif")" - tmp="${OUT_DIR}/tmp-${fname}" - out="${OUT_DIR}/${fname%.*}-opt.gif" - - ffmpeg -y -i "$gif" -vf "scale='min(${MAX_WIDTH},iw)':'-2',fps=${FPS}" "$tmp" - if command -v gifsicle >/dev/null 2>&1; then - gifsicle -O3 "$tmp" -o "$out" - else - mv "$tmp" "$out" - fi - echo "Optimized: $out" -done -EOF - -chmod +x scripts/optimize_gifs.sh +# LinuxDroid helper menu (if installed) +./menu.sh +``` + +--- + +## πŸ”— Installation Link + +Primary project for multi-OS Android Linux installs: + +**[LinuxDroid](https://github.com/AryanVBW/LinuxDroid)** β€” install Kali, Parrot, Ubuntu, Debian, and more on Android. + +This repository focuses on the Kali / NetHunter experience. For the full LinuxDroid installer and OS list, use the link above. + +--- + +## ⚠️ Security and Legal Notice + +Use these tools **only** on systems and networks you own or have explicit permission to test. + +Unauthorized access, scanning, or exploitation of systems is illegal. The authors and contributors are not responsible for misuse. This project is intended for education, research, and ethical security practice. + +--- + +## 🀝 Contributing and Support + +- Report issues, suggest enhancements, or open pull requests +- Keep documentation clear and commands copy-paste ready +- For maintainer GIF optimization: + +```bash ./scripts/optimize_gifs.sh 640 15 -git add assets/gifs/optimized/* -git commit -m "Add optimized README GIFs" -git push origin main +``` + +See [`scripts/optimize_gifs.sh`](scripts/optimize_gifs.sh) for details. --- - +## πŸ“œ Credits and License + +- [Kali Linux / Offensive Security](https://www.kali.org/) +- [LinuxDroid](https://github.com/AryanVBW/LinuxDroid) by [AryanVBW](https://github.com/AryanVBW) +- Community contributors + +Licensed under the terms of this repository. See the project license for details. diff --git a/assets/gifs/debian-logo.svg b/assets/gifs/debian-logo.svg new file mode 100644 index 0000000..50dcb70 --- /dev/null +++ b/assets/gifs/debian-logo.svg @@ -0,0 +1,86 @@ + + + + + + + + + + + + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/assets/gifs/kali-logo.svg b/assets/gifs/kali-logo.svg new file mode 100644 index 0000000..71ce603 --- /dev/null +++ b/assets/gifs/kali-logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/gifs/parrot-logo.svg b/assets/gifs/parrot-logo.svg new file mode 100644 index 0000000..8eefdbd --- /dev/null +++ b/assets/gifs/parrot-logo.svg @@ -0,0 +1 @@ +Parrot Security \ No newline at end of file diff --git a/assets/gifs/ubuntu-logo.svg b/assets/gifs/ubuntu-logo.svg new file mode 100644 index 0000000..c49d351 --- /dev/null +++ b/assets/gifs/ubuntu-logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/scripts/optimize_gifs.sh b/scripts/optimize_gifs.sh new file mode 100755 index 0000000..0070cbf --- /dev/null +++ b/scripts/optimize_gifs.sh @@ -0,0 +1,40 @@ +#!/usr/bin/env bash +# optimize_gifs.sh β€” shrink README demo GIFs for faster loading +# Usage: ./scripts/optimize_gifs.sh [max_width] [fps] +# Example: ./scripts/optimize_gifs.sh 640 15 + +set -euo pipefail + +MAX_WIDTH="${1:-640}" +FPS="${2:-15}" +SRC_DIR="assets/gifs" +OUT_DIR="${SRC_DIR}/optimized" + +mkdir -p "$OUT_DIR" + +if ! command -v ffmpeg >/dev/null 2>&1; then + echo "ffmpeg is required. Install with: pkg install ffmpeg OR apt install ffmpeg" >&2 + exit 1 +fi + +shopt -s nullglob +gifs=("$SRC_DIR"/*.gif) +if [ ${#gifs[@]} -eq 0 ]; then + echo "No GIFs found in $SRC_DIR" + exit 0 +fi + +for gif in "${gifs[@]}"; do + fname="$(basename "$gif")" + tmp="${OUT_DIR}/tmp-${fname}" + out="${OUT_DIR}/${fname%.*}-opt.gif" + + ffmpeg -y -i "$gif" -vf "scale='min(${MAX_WIDTH},iw)':'-2',fps=${FPS}" "$tmp" + if command -v gifsicle >/dev/null 2>&1; then + gifsicle -O3 "$tmp" -o "$out" + rm -f "$tmp" + else + mv "$tmp" "$out" + fi + echo "Optimized: $out" +done From f33f74e38e3ccdd66cc77bb024ccf1d49cd3e15d Mon Sep 17 00:00:00 2001 From: Sanjana Date: Sat, 18 Jul 2026 23:49:18 +0530 Subject: [PATCH 4/6] fix(docs): apply only required PR review fixes Fix badges, trim TOC to existing sections, use working logo URLs, and split Quick Install into Option A/B. Drop the earlier extra rewrite. --- README.md | 232 ++++++------------------------------ assets/gifs/debian-logo.svg | 86 ------------- assets/gifs/kali-logo.svg | 1 - assets/gifs/parrot-logo.svg | 1 - assets/gifs/ubuntu-logo.svg | 1 - scripts/optimize_gifs.sh | 40 ------- 6 files changed, 36 insertions(+), 325 deletions(-) delete mode 100644 assets/gifs/debian-logo.svg delete mode 100644 assets/gifs/kali-logo.svg delete mode 100644 assets/gifs/parrot-logo.svg delete mode 100644 assets/gifs/ubuntu-logo.svg delete mode 100755 scripts/optimize_gifs.sh diff --git a/README.md b/README.md index 8053374..8be7188 100644 --- a/README.md +++ b/README.md @@ -1,46 +1,31 @@ # Kali-Linux-for-Android β€” Kali Magic πŸŽ©πŸ” -> Transform your Android device into a **portable cybersecurity playground** β€” run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). +> Transform your Android device into a **portable cybersecurity playground** β€” run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). πŸš€πŸ’»πŸ“± [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Releases](https://img.shields.io/github/v/release/AryanVBW/Kali-Linux-for-Android)](https://github.com/AryanVBW/Kali-Linux-for-Android/releases) [![Downloads](https://img.shields.io/github/downloads/AryanVBW/Kali-Linux-for-Android/total)](https://github.com/AryanVBW/Kali-Linux-for-Android/releases) -

- - Visit LinuxDroid - -

- --- ## πŸ“– Table of Contents -- [About](#about) -- [Supported Operating Systems](#supported-operating-systems) -- [Features](#features) -- [Prerequisites](#prerequisites) +- [About](#about) +- [Supported Operating Systems](#supported-operating-systems) +- [Features](#features) +- [Prerequisites](#prerequisites) - [Quick Install](#quick-install) -- [Manual Installation](#manual-installation) -- [Kali NetHunter (Rootless)](#kali-nethunter-rootless) -- [Visual Demos](#visual-demos) - - [Nmap](#nmap) - - [Metasploit](#metasploit) - - [Wireshark](#wireshark) - - [Installer Walkthrough](#installer-walkthrough) -- [Usage Examples](#usage-examples) -- [Installation Link](#installation-link) -- [Security and Legal Notice](#security-and-legal-notice) -- [Contributing and Support](#contributing-and-support) -- [Credits and License](#credits-and-license) --- ## 🧠 About -**Kali Magic** lets you experience **Kali Linux / Parrot OS / NetHunter** tools right on Android β€” perfect for **students, researchers, and ethical hackers** learning on the go. +**Kali Magic** lets you experience **Kali Linux / Parrot OS / NetHunter** tools right on Android β€” perfect for **students, researchers, and ethical hackers** learning on the go. + +Run full penetration-testing environments inside **Termux + LinuxDroid**. +It’s portable, rootless, and visually documented with live demos. -Run full penetration-testing environments inside **Termux + LinuxDroid**. It is portable, rootless, and documented with clear install paths and usage examples. +[![Visit LinuxDroid](https://github.com/AryanVBW/ParrotSecurityOsForAndroid/releases/download/Gif/visithere.gif)](https://github.com/AryanVBW/LinuxDroid) --- @@ -48,224 +33,79 @@ Run full penetration-testing environments inside **Termux + LinuxDroid**. It is | OS | Version | Description | Logo | |----|---------|-------------|------| -| **Kali Linux** | Rolling | Advanced penetration testing and security distro. | Kali Logo | -| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy, and developer tools. | Parrot Logo | -| **Ubuntu** | 20.04+ | General-purpose Linux for development and scripting. | Ubuntu Logo | -| **Debian** | 11+ | Stable, server-ready Linux distribution. | Debian Logo | +| **Kali Linux** | Rolling | Advanced penetration testing & security distro. | Kali Logo | +| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy & dev tools. | Parrot Logo | +| **Ubuntu** | 20.04+ | General-purpose Linux for dev & scripting. | Ubuntu Logo | +| **Debian** | 11+ | Stable, server-ready Linux distribution. | Debian Logo | --- ## 🌟 Features -- Mobile-optimized environment for Kali / NetHunter tools -- Run powerful pentest tools inside Termux / proot (rootless) -- Quick installer with two clear install paths -- Copy-paste-ready commands for common tools -- Safe for educational and ethical security labs +- Mobile-optimized environment for Kali / NetHunter tools. +- Run powerful pentest tools inside Termux/proot (rootless). +- Quick installer + visual setup walkthrough. +- Lightweight GIF demos and prebuilt commands. +- Safe for educational / ethical security labs. --- ## βš™οΈ Prerequisites -- Android 7.0+ -- [Termux](https://f-droid.org/packages/com.termux/) (from F-Droid) -- `termux-setup-storage` permission granted -- Disk: ~3–8 GB free space -- (Optional) Root access for Wi-Fi injection or OTG tools +- Android 7.0+ +- Termux (from F-Droid) +- `termux-setup-storage` permission granted +- Disk: ~3-8 GB free space +- (Optional) Root access for Wi-Fi injection or OTG tools -> Always inspect scripts before running: +> πŸ’‘ Always inspect scripts before running: > ```bash -> cat install-nethunter-termux +> cat install.sh > ``` --- ## πŸš€ Quick Install -Choose **one** path below β€” do not run both. - -### Option A: Direct Termux (NetHunter Rootless) - -Best for a quick Kali NetHunter rootless setup inside Termux. +### Option A: Direct Termux ```bash pkg update && pkg upgrade -y pkg install wget curl proot -y -# Download and run Kali NetHunter installer +# Download & run Kali NetHunter installer wget -O install-nethunter-termux https://offs.ec/2MceZWr chmod +x install-nethunter-termux ./install-nethunter-termux -# Optional: LinuxDroid menu helpers -wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh -chmod +x menu.sh +# Optional extras (LinuxDroid) +wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh && chmod +x menu.sh -# Optional: bash presets -cp ~/.bashrc ~/.bashrc.backup 2>/dev/null || true +# Optional bash presets +cp ~/.bashrc ~/.bashrc.backup || true wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -O ~/.bashrc -# Start GUI (after install completes) +# Start GUI nethunter kex & ./menu.sh ``` ### Option B: Debian via proot-distro -Best if you want a full Debian container, then install Kali tools inside it. - ```bash -pkg update && pkg upgrade -y -pkg install wget curl proot-distro -y - +pkg install proot-distro proot-distro list proot-distro install debian proot-distro login debian ``` -Inside the Debian container: +Inside Debian: ```bash apt update && apt upgrade -y apt install kali-tools-top10 -y - -# Optional: NetHunter-style tooling inside the container wget -O install-nethunter-termux https://offs.ec/2MceZWr chmod +x install-nethunter-termux ./install-nethunter-termux +nethunter kex & ``` - ---- - -## πŸ› οΈ Manual Installation - -1. Install Termux from F-Droid (not Play Store). -2. Open Termux and grant storage access: - ```bash - termux-setup-storage - ``` -3. Follow **Option A** or **Option B** in [Quick Install](#quick-install). -4. For a multi-distro Android Linux experience, use [LinuxDroid](https://github.com/AryanVBW/LinuxDroid). - ---- - -## πŸ‰ Kali NetHunter (Rootless) - -Kali NetHunter Rootless runs on stock, unrooted Android via Termux. It is based on Kali Linux and provides a mobile penetration-testing platform for learning and research. - -With NetHunter Rootless you can: - -- Practice ethical hacking and security research on Android -- Use common Kali tools in a portable environment -- Learn without requiring a rooted device - -After installation: - -```bash -nethunter # enter NetHunter CLI -nethunter kex & # start KeX GUI session (if configured) -``` - -Official guide: [Kali NetHunter Rootless](https://www.kali.org/docs/nethunter/nethunter-rootless/) - ---- - -## 🎬 Visual Demos - -### Nmap - -Scan a local subnet (replace with a network you own or have permission to test): - -```bash -nmap -sS 192.168.1.0/24 -nmap -A 192.168.1.1 -``` - -### Metasploit - -```bash -msfconsole -``` - -### Wireshark - -On devices with GUI / KeX support: - -```bash -wireshark -# or capture from CLI -tshark -i any -c 50 -``` - -### Installer Walkthrough - -1. Update Termux packages -2. Run the NetHunter installer (**Option A**) or set up Debian (**Option B**) -3. Launch `nethunter` / `menu.sh` -4. Install tools as needed (`nmap`, `metasploit-framework`, etc.) - -

- - Installer walkthrough - -

- ---- - -## πŸ’‘ Usage Examples - -```bash -# List tools (Debian / Kali container) -ls /usr/share/ - -# Network discovery (authorized networks only) -nmap -sn 192.168.1.0/24 - -# Start Metasploit -msfconsole - -# LinuxDroid helper menu (if installed) -./menu.sh -``` - ---- - -## πŸ”— Installation Link - -Primary project for multi-OS Android Linux installs: - -**[LinuxDroid](https://github.com/AryanVBW/LinuxDroid)** β€” install Kali, Parrot, Ubuntu, Debian, and more on Android. - -This repository focuses on the Kali / NetHunter experience. For the full LinuxDroid installer and OS list, use the link above. - ---- - -## ⚠️ Security and Legal Notice - -Use these tools **only** on systems and networks you own or have explicit permission to test. - -Unauthorized access, scanning, or exploitation of systems is illegal. The authors and contributors are not responsible for misuse. This project is intended for education, research, and ethical security practice. - ---- - -## 🀝 Contributing and Support - -- Report issues, suggest enhancements, or open pull requests -- Keep documentation clear and commands copy-paste ready -- For maintainer GIF optimization: - -```bash -./scripts/optimize_gifs.sh 640 15 -``` - -See [`scripts/optimize_gifs.sh`](scripts/optimize_gifs.sh) for details. - ---- - -## πŸ“œ Credits and License - -- [Kali Linux / Offensive Security](https://www.kali.org/) -- [LinuxDroid](https://github.com/AryanVBW/LinuxDroid) by [AryanVBW](https://github.com/AryanVBW) -- Community contributors - -Licensed under the terms of this repository. See the project license for details. diff --git a/assets/gifs/debian-logo.svg b/assets/gifs/debian-logo.svg deleted file mode 100644 index 50dcb70..0000000 --- a/assets/gifs/debian-logo.svg +++ /dev/null @@ -1,86 +0,0 @@ - - - - - - - - - - - - - -]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/assets/gifs/kali-logo.svg b/assets/gifs/kali-logo.svg deleted file mode 100644 index 71ce603..0000000 --- a/assets/gifs/kali-logo.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/assets/gifs/parrot-logo.svg b/assets/gifs/parrot-logo.svg deleted file mode 100644 index 8eefdbd..0000000 --- a/assets/gifs/parrot-logo.svg +++ /dev/null @@ -1 +0,0 @@ -Parrot Security \ No newline at end of file diff --git a/assets/gifs/ubuntu-logo.svg b/assets/gifs/ubuntu-logo.svg deleted file mode 100644 index c49d351..0000000 --- a/assets/gifs/ubuntu-logo.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/scripts/optimize_gifs.sh b/scripts/optimize_gifs.sh deleted file mode 100755 index 0070cbf..0000000 --- a/scripts/optimize_gifs.sh +++ /dev/null @@ -1,40 +0,0 @@ -#!/usr/bin/env bash -# optimize_gifs.sh β€” shrink README demo GIFs for faster loading -# Usage: ./scripts/optimize_gifs.sh [max_width] [fps] -# Example: ./scripts/optimize_gifs.sh 640 15 - -set -euo pipefail - -MAX_WIDTH="${1:-640}" -FPS="${2:-15}" -SRC_DIR="assets/gifs" -OUT_DIR="${SRC_DIR}/optimized" - -mkdir -p "$OUT_DIR" - -if ! command -v ffmpeg >/dev/null 2>&1; then - echo "ffmpeg is required. Install with: pkg install ffmpeg OR apt install ffmpeg" >&2 - exit 1 -fi - -shopt -s nullglob -gifs=("$SRC_DIR"/*.gif) -if [ ${#gifs[@]} -eq 0 ]; then - echo "No GIFs found in $SRC_DIR" - exit 0 -fi - -for gif in "${gifs[@]}"; do - fname="$(basename "$gif")" - tmp="${OUT_DIR}/tmp-${fname}" - out="${OUT_DIR}/${fname%.*}-opt.gif" - - ffmpeg -y -i "$gif" -vf "scale='min(${MAX_WIDTH},iw)':'-2',fps=${FPS}" "$tmp" - if command -v gifsicle >/dev/null 2>&1; then - gifsicle -O3 "$tmp" -o "$out" - rm -f "$tmp" - else - mv "$tmp" "$out" - fi - echo "Optimized: $out" -done From a11a235c589905469574b2ef769b53f7f7bec56d Mon Sep 17 00:00:00 2001 From: Sanjana Date: Sat, 18 Jul 2026 23:57:28 +0530 Subject: [PATCH 5/6] fix README based on review feedback --- README.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 8be7188..1f17c16 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,7 @@ It’s portable, rootless, and visually documented with live demos. - Android 7.0+ - Termux (from F-Droid) - `termux-setup-storage` permission granted -- Disk: ~3-8 GB free space +- Disk space: ~3–5 GB for Option A (NetHunter), ~2–3 GB for Option B (Debian) - (Optional) Root access for Wi-Fi injection or OTG tools > πŸ’‘ Always inspect scripts before running: @@ -85,13 +85,16 @@ wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh cp ~/.bashrc ~/.bashrc.backup || true wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -O ~/.bashrc -# Start GUI +# Start GUI (set KeX password first) +nethunter kex passwd nethunter kex & ./menu.sh ``` ### Option B: Debian via proot-distro +For NetHunter, use Option A. This path is just a Debian container. + ```bash pkg install proot-distro proot-distro list @@ -103,9 +106,5 @@ Inside Debian: ```bash apt update && apt upgrade -y -apt install kali-tools-top10 -y -wget -O install-nethunter-termux https://offs.ec/2MceZWr -chmod +x install-nethunter-termux -./install-nethunter-termux -nethunter kex & +# install whatever you need, e.g. apt install nmap ``` From 7971f38aa90435f87c2961350660e06df83737fd Mon Sep 17 00:00:00 2001 From: Sanjana Date: Sun, 19 Jul 2026 00:05:04 +0530 Subject: [PATCH 6/6] pin install script urls to specific commits --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1f17c16..2dad0e5 100644 --- a/README.md +++ b/README.md @@ -73,17 +73,17 @@ It’s portable, rootless, and visually documented with live demos. pkg update && pkg upgrade -y pkg install wget curl proot -y -# Download & run Kali NetHunter installer -wget -O install-nethunter-termux https://offs.ec/2MceZWr +# Download & run Kali NetHunter installer (pinned revision) +wget -O install-nethunter-termux https://gitlab.com/kalilinux/nethunter/build-scripts/kali-nethunter-rootless/-/raw/07d66e8b51eee8d0e19ea7b4a8050dcbf3e08391/install-nethunter-termux chmod +x install-nethunter-termux ./install-nethunter-termux # Optional extras (LinuxDroid) -wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh && chmod +x menu.sh +wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/2b2ff0f3d0d340ca13905177f545793da2b8101c/Scripts/menu.sh && chmod +x menu.sh # Optional bash presets cp ~/.bashrc ~/.bashrc.backup || true -wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -O ~/.bashrc +wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/4faaad1f16cce15776061f2a3226160dc253bbef/Scripts/default.bashrc -O ~/.bashrc # Start GUI (set KeX password first) nethunter kex passwd