Skip to content

jorexdeveloper/termux-nethunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TERMUX NETHUNTER

image could not be loaded

Install Kali NetHunter in Termux.

Author: Jore

Version: 2023.3b

CONTENTS

FEATURES

  • Anti-root fuse.
  • Interactive Installation.
  • Color output. (if supported)
  • Command line options. (see here)
    • Install in custom directory.
    • Install only i.e no configurations. (use with caution)
    • Configurations only (if already installed)
    • Modify color output.
    • Uninstall.
  • Creates a VNC wrapper (see here)
  • Automatic configurations. (i.e binding necessary directories)
  • Access System and Termux commands. (i.e termux-api commands)
  • Customize default shell and zone information before startup.
  • Other optimizations and improvements.

INSTALLATION

  1. Update installed packages by executing the following commands.
pkg update && pkg upgrade
  1. Install wget. (curl is an alternative)
pkg install wget
  1. Download the installer script. (install-nethunter.sh)
wget -O install-nethunter.sh https://raw.githubusercontent.com/jorexdeveloper/termux-nethunter/main/install-nethunter.sh
  1. Now execute the installer script.
bash install-nethunter.sh --help

If you are lazy like me, just copy and paste the below commands in Termux.

pkg update -y && pkg upgrade -y && pkg install -y wget && wget -O install-nethunter.sh https://raw.githubusercontent.com/jorexdeveloper/termux-nethunter/main/install-nethunter.sh && bash install-nethunter.sh --help

COMMAND LINE OPTIONS

Execute the installer script with --help to see available command line options.

bash install-nethunter.sh --help

HOW TO LOGIN

After successful installation, run command nh or nethunter to start Kali NetHunter.

LOGIN INFORMATION

Login Password
root (super user) root
kali (normal user} kali

HOW TO START THE VNC SERVER

REQUIREMENTS:

  1. Make sure you have a VNC server and Desktop environment installed. (The full installation has them pre-installed, see here)

  2. Install NetHunter KeX, or a VNC viewer of your choice.

PROCEDURE:

  1. Login in Kali NetHunter and run command vnc to start the VNC server. The server will be started at localhost (127.0.0.1).

Tip: The program also displays help information with option -h or --help to guide you further.

  1. On the first run, you will be prompted for a password. You will use this password to login and connect to the VNC server.

  2. Now open NetHunter KeX and login with the password in step 2.

User Display Port Address
Root :0 5900 localhost:0
Other :1 5901 localhost:1

HOW TO INSTALL XFCE AND VNC SERVER

  1. Login in Kali NetHunter.

  2. Make a full upgrade of your system.

sudo apt update && sudo apt full-upgrade
  1. Run the following commands.
sudo apt install dbus-x11 tigervnc-standalone-server kali-desktop-xfce

Tip: This will take a while, just make sure you don't exit Termux during the installation or you might run into some problems later.

USING AS ROOT

Installing/Running Kali NetHunter as root can have unintended effects, and should only be done when you are sure of what's happening in the background (how linux works) or you might damage your device, even worse bricking it.

For that reason, I have added an anti root fuse and disabling it will require you to comment out the appropriate lines from the installer script.

NOTE: You can still have root privileges within Kali NetHunter provided by proot, even without installing as root. (see the proot manual pages)

You will have to search and comment out the function call to check_root in the installer script. i.e

  ...
  # check_root
  ...

HOW TO UNINSTALL KALI NETHUNTER

To uninstall Kali NetHunter, run the installer script (install-nethunter.sh) with option --uninstall.

NOTE: If you installed Kali NetHunter in a custom directory, also supply the path to the directory as an argument.

bash install-nethunter.sh --uninstall

BUGS

All currently known bugs are fixed. Please let me know in the issues section if you find any.

LICENSE

    Copyright (C) 2023  Jore

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.