|
1 | 1 | # Kali-Linux-for-Android — Kali Magic 🎩🔐 |
2 | 2 |
|
3 | | -> Transform your Android device into a **portable cybersecurity playground** — run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). |
| 3 | +> Transform your Android device into a **portable cybersecurity playground** — run Kali / NetHunter tools on Android (Termux / LinuxDroid integration). 🚀💻📱 |
4 | 4 |
|
5 | 5 | [](LICENSE) |
6 | 6 | [](https://github.com/AryanVBW/Kali-Linux-for-Android/releases) |
7 | 7 | [](https://github.com/AryanVBW/Kali-Linux-for-Android/releases) |
8 | 8 |
|
9 | | -<p align="center"> |
10 | | - <a href="https://github.com/AryanVBW/LinuxDroid"> |
11 | | - <img src="https://github.com/AryanVBW/ParrotSecurityOsForAndroid/releases/download/Gif/visithere.gif" alt="Visit LinuxDroid" width="520"> |
12 | | - </a> |
13 | | -</p> |
14 | | - |
15 | 9 | --- |
16 | 10 |
|
17 | 11 | ## 📖 Table of Contents |
18 | 12 |
|
19 | | -- [About](#about) |
20 | | -- [Supported Operating Systems](#supported-operating-systems) |
21 | | -- [Features](#features) |
22 | | -- [Prerequisites](#prerequisites) |
| 13 | +- [About](#about) |
| 14 | +- [Supported Operating Systems](#supported-operating-systems) |
| 15 | +- [Features](#features) |
| 16 | +- [Prerequisites](#prerequisites) |
23 | 17 | - [Quick Install](#quick-install) |
24 | | -- [Manual Installation](#manual-installation) |
25 | | -- [Kali NetHunter (Rootless)](#kali-nethunter-rootless) |
26 | | -- [Visual Demos](#visual-demos) |
27 | | - - [Nmap](#nmap) |
28 | | - - [Metasploit](#metasploit) |
29 | | - - [Wireshark](#wireshark) |
30 | | - - [Installer Walkthrough](#installer-walkthrough) |
31 | | -- [Usage Examples](#usage-examples) |
32 | | -- [Installation Link](#installation-link) |
33 | | -- [Security and Legal Notice](#security-and-legal-notice) |
34 | | -- [Contributing and Support](#contributing-and-support) |
35 | | -- [Credits and License](#credits-and-license) |
36 | 18 |
|
37 | 19 | --- |
38 | 20 |
|
39 | 21 | ## 🧠 About |
40 | 22 |
|
41 | | -**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. |
| 23 | +**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. |
| 24 | + |
| 25 | +Run full penetration-testing environments inside **Termux + LinuxDroid**. |
| 26 | +It’s portable, rootless, and visually documented with live demos. |
42 | 27 |
|
43 | | -Run full penetration-testing environments inside **Termux + LinuxDroid**. It is portable, rootless, and documented with clear install paths and usage examples. |
| 28 | +[](https://github.com/AryanVBW/LinuxDroid) |
44 | 29 |
|
45 | 30 | --- |
46 | 31 |
|
47 | 32 | ## 🐧 Supported Operating Systems |
48 | 33 |
|
49 | 34 | | OS | Version | Description | Logo | |
50 | 35 | |----|---------|-------------|------| |
51 | | -| **Kali Linux** | Rolling | Advanced penetration testing and security distro. | <img src="assets/gifs/kali-logo.svg" alt="Kali Logo" width="48"> | |
52 | | -| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy, and developer tools. | <img src="assets/gifs/parrot-logo.svg" alt="Parrot Logo" width="48"> | |
53 | | -| **Ubuntu** | 20.04+ | General-purpose Linux for development and scripting. | <img src="assets/gifs/ubuntu-logo.svg" alt="Ubuntu Logo" width="48"> | |
54 | | -| **Debian** | 11+ | Stable, server-ready Linux distribution. | <img src="assets/gifs/debian-logo.svg" alt="Debian Logo" width="48"> | |
| 36 | +| **Kali Linux** | Rolling | Advanced penetration testing & security distro. | <img src="https://www.kali.org/images/kali-logo.svg" alt="Kali Logo" width="40"> | |
| 37 | +| **Parrot Security OS** | Rolling | Forensics, pen-testing, privacy & dev tools. | <img src="https://cdn.jsdelivr.net/gh/simple-icons/simple-icons/icons/parrotsecurity.svg" alt="Parrot Logo" width="40"> | |
| 38 | +| **Ubuntu** | 20.04+ | General-purpose Linux for dev & scripting. | <img src="https://assets.ubuntu.com/v1/ce518a18-CoF-2022_solid+O.svg" alt="Ubuntu Logo" width="40"> | |
| 39 | +| **Debian** | 11+ | Stable, server-ready Linux distribution. | <img src="https://www.debian.org/logos/openlogo-nd.svg" alt="Debian Logo" width="40"> | |
55 | 40 |
|
56 | 41 | --- |
57 | 42 |
|
58 | 43 | ## 🌟 Features |
59 | 44 |
|
60 | | -- Mobile-optimized environment for Kali / NetHunter tools |
61 | | -- Run powerful pentest tools inside Termux / proot (rootless) |
62 | | -- Quick installer with two clear install paths |
63 | | -- Copy-paste-ready commands for common tools |
64 | | -- Safe for educational and ethical security labs |
| 45 | +- Mobile-optimized environment for Kali / NetHunter tools. |
| 46 | +- Run powerful pentest tools inside Termux/proot (rootless). |
| 47 | +- Quick installer + visual setup walkthrough. |
| 48 | +- Lightweight GIF demos and prebuilt commands. |
| 49 | +- Safe for educational / ethical security labs. |
65 | 50 |
|
66 | 51 | --- |
67 | 52 |
|
68 | 53 | ## ⚙️ Prerequisites |
69 | 54 |
|
70 | | -- Android 7.0+ |
71 | | -- [Termux](https://f-droid.org/packages/com.termux/) (from F-Droid) |
72 | | -- `termux-setup-storage` permission granted |
73 | | -- Disk: ~3–8 GB free space |
74 | | -- (Optional) Root access for Wi-Fi injection or OTG tools |
| 55 | +- Android 7.0+ |
| 56 | +- Termux (from F-Droid) |
| 57 | +- `termux-setup-storage` permission granted |
| 58 | +- Disk: ~3-8 GB free space |
| 59 | +- (Optional) Root access for Wi-Fi injection or OTG tools |
75 | 60 |
|
76 | | -> Always inspect scripts before running: |
| 61 | +> 💡 Always inspect scripts before running: |
77 | 62 | > ```bash |
78 | | -> cat install-nethunter-termux |
| 63 | +> cat install.sh |
79 | 64 | > ``` |
80 | 65 |
|
81 | 66 | --- |
82 | 67 |
|
83 | 68 | ## 🚀 Quick Install |
84 | 69 |
|
85 | | -Choose **one** path below — do not run both. |
86 | | -
|
87 | | -### Option A: Direct Termux (NetHunter Rootless) |
88 | | -
|
89 | | -Best for a quick Kali NetHunter rootless setup inside Termux. |
| 70 | +### Option A: Direct Termux |
90 | 71 |
|
91 | 72 | ```bash |
92 | 73 | pkg update && pkg upgrade -y |
93 | 74 | pkg install wget curl proot -y |
94 | 75 |
|
95 | | -# Download and run Kali NetHunter installer |
| 76 | +# Download & run Kali NetHunter installer |
96 | 77 | wget -O install-nethunter-termux https://offs.ec/2MceZWr |
97 | 78 | chmod +x install-nethunter-termux |
98 | 79 | ./install-nethunter-termux |
99 | 80 |
|
100 | | -# Optional: LinuxDroid menu helpers |
101 | | -wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh |
102 | | -chmod +x menu.sh |
| 81 | +# Optional extras (LinuxDroid) |
| 82 | +wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/menu.sh && chmod +x menu.sh |
103 | 83 |
|
104 | | -# Optional: bash presets |
105 | | -cp ~/.bashrc ~/.bashrc.backup 2>/dev/null || true |
| 84 | +# Optional bash presets |
| 85 | +cp ~/.bashrc ~/.bashrc.backup || true |
106 | 86 | wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/default.bashrc -O ~/.bashrc |
107 | 87 |
|
108 | | -# Start GUI (after install completes) |
| 88 | +# Start GUI |
109 | 89 | nethunter kex & |
110 | 90 | ./menu.sh |
111 | 91 | ``` |
112 | 92 |
|
113 | 93 | ### Option B: Debian via proot-distro |
114 | 94 |
|
115 | | -Best if you want a full Debian container, then install Kali tools inside it. |
116 | | - |
117 | 95 | ```bash |
118 | | -pkg update && pkg upgrade -y |
119 | | -pkg install wget curl proot-distro -y |
120 | | - |
| 96 | +pkg install proot-distro |
121 | 97 | proot-distro list |
122 | 98 | proot-distro install debian |
123 | 99 | proot-distro login debian |
124 | 100 | ``` |
125 | 101 |
|
126 | | -Inside the Debian container: |
| 102 | +Inside Debian: |
127 | 103 |
|
128 | 104 | ```bash |
129 | 105 | apt update && apt upgrade -y |
130 | 106 | apt install kali-tools-top10 -y |
131 | | - |
132 | | -# Optional: NetHunter-style tooling inside the container |
133 | 107 | wget -O install-nethunter-termux https://offs.ec/2MceZWr |
134 | 108 | chmod +x install-nethunter-termux |
135 | 109 | ./install-nethunter-termux |
| 110 | +nethunter kex & |
136 | 111 | ``` |
137 | | - |
138 | | ---- |
139 | | - |
140 | | -## 🛠️ Manual Installation |
141 | | - |
142 | | -1. Install Termux from F-Droid (not Play Store). |
143 | | -2. Open Termux and grant storage access: |
144 | | - ```bash |
145 | | - termux-setup-storage |
146 | | - ``` |
147 | | -3. Follow **Option A** or **Option B** in [Quick Install](#quick-install). |
148 | | -4. For a multi-distro Android Linux experience, use [LinuxDroid](https://github.com/AryanVBW/LinuxDroid). |
149 | | - |
150 | | ---- |
151 | | - |
152 | | -## 🐉 Kali NetHunter (Rootless) |
153 | | - |
154 | | -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. |
155 | | - |
156 | | -With NetHunter Rootless you can: |
157 | | - |
158 | | -- Practice ethical hacking and security research on Android |
159 | | -- Use common Kali tools in a portable environment |
160 | | -- Learn without requiring a rooted device |
161 | | - |
162 | | -After installation: |
163 | | - |
164 | | -```bash |
165 | | -nethunter # enter NetHunter CLI |
166 | | -nethunter kex & # start KeX GUI session (if configured) |
167 | | -``` |
168 | | - |
169 | | -Official guide: [Kali NetHunter Rootless](https://www.kali.org/docs/nethunter/nethunter-rootless/) |
170 | | - |
171 | | ---- |
172 | | - |
173 | | -## 🎬 Visual Demos |
174 | | - |
175 | | -### Nmap |
176 | | - |
177 | | -Scan a local subnet (replace with a network you own or have permission to test): |
178 | | - |
179 | | -```bash |
180 | | -nmap -sS 192.168.1.0/24 |
181 | | -nmap -A 192.168.1.1 |
182 | | -``` |
183 | | - |
184 | | -### Metasploit |
185 | | - |
186 | | -```bash |
187 | | -msfconsole |
188 | | -``` |
189 | | - |
190 | | -### Wireshark |
191 | | - |
192 | | -On devices with GUI / KeX support: |
193 | | - |
194 | | -```bash |
195 | | -wireshark |
196 | | -# or capture from CLI |
197 | | -tshark -i any -c 50 |
198 | | -``` |
199 | | - |
200 | | -### Installer Walkthrough |
201 | | - |
202 | | -1. Update Termux packages |
203 | | -2. Run the NetHunter installer (**Option A**) or set up Debian (**Option B**) |
204 | | -3. Launch `nethunter` / `menu.sh` |
205 | | -4. Install tools as needed (`nmap`, `metasploit-framework`, etc.) |
206 | | - |
207 | | -<p align="center"> |
208 | | - <a href="https://github.com/AryanVBW/LinuxDroid"> |
209 | | - <img src="https://github.com/AryanVBW/ParrotSecurityOsForAndroid/releases/download/Gif/visithere.gif" alt="Installer walkthrough" width="480"> |
210 | | - </a> |
211 | | -</p> |
212 | | - |
213 | | ---- |
214 | | - |
215 | | -## 💡 Usage Examples |
216 | | - |
217 | | -```bash |
218 | | -# List tools (Debian / Kali container) |
219 | | -ls /usr/share/ |
220 | | - |
221 | | -# Network discovery (authorized networks only) |
222 | | -nmap -sn 192.168.1.0/24 |
223 | | - |
224 | | -# Start Metasploit |
225 | | -msfconsole |
226 | | - |
227 | | -# LinuxDroid helper menu (if installed) |
228 | | -./menu.sh |
229 | | -``` |
230 | | - |
231 | | ---- |
232 | | - |
233 | | -## 🔗 Installation Link |
234 | | - |
235 | | -Primary project for multi-OS Android Linux installs: |
236 | | - |
237 | | -**[LinuxDroid](https://github.com/AryanVBW/LinuxDroid)** — install Kali, Parrot, Ubuntu, Debian, and more on Android. |
238 | | - |
239 | | -This repository focuses on the Kali / NetHunter experience. For the full LinuxDroid installer and OS list, use the link above. |
240 | | - |
241 | | ---- |
242 | | - |
243 | | -## ⚠️ Security and Legal Notice |
244 | | - |
245 | | -Use these tools **only** on systems and networks you own or have explicit permission to test. |
246 | | - |
247 | | -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. |
248 | | - |
249 | | ---- |
250 | | - |
251 | | -## 🤝 Contributing and Support |
252 | | - |
253 | | -- Report issues, suggest enhancements, or open pull requests |
254 | | -- Keep documentation clear and commands copy-paste ready |
255 | | -- For maintainer GIF optimization: |
256 | | - |
257 | | -```bash |
258 | | -./scripts/optimize_gifs.sh 640 15 |
259 | | -``` |
260 | | - |
261 | | -See [`scripts/optimize_gifs.sh`](scripts/optimize_gifs.sh) for details. |
262 | | - |
263 | | ---- |
264 | | - |
265 | | -## 📜 Credits and License |
266 | | - |
267 | | -- [Kali Linux / Offensive Security](https://www.kali.org/) |
268 | | -- [LinuxDroid](https://github.com/AryanVBW/LinuxDroid) by [AryanVBW](https://github.com/AryanVBW) |
269 | | -- Community contributors |
270 | | - |
271 | | -Licensed under the terms of this repository. See the project license for details. |
0 commit comments