UI Documentation

Functions

banner()

prints PyHTools Banner on UI Screen

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def banner():
    '''prints PyHTools Banner on UI Screen

    Args:
        None

    Returns:
        None
    '''
    clrscr()
    print(BRIGHT_YELLOW + pyfiglet.figlet_format('PyHTools'))
    print(BRIGHT_YELLOW + '+' + '-'*42 + '+')
    print(BRIGHT_WHITE + f'| written by dmdhrumilmistry               |')
    print(BRIGHT_YELLOW + '+' + '-'*42 + '+')

clrscr()

Clears UI screen

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def clrscr():
    '''Clears UI screen

    Args:
        None

    Returns:
        None
    '''
    if os.name == 'nt':
        os.system('cls')
    elif os.name == 'posix':
        os.system('clear')

generate_executable()

executes commands to generate executables. Work in Progress

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def generate_executable():
    '''executes commands to generate executables. Work in Progress

    Args:
        None

    Returns:
        None
    '''
    print(BRIGHT_YELLOW +
          '[-] Currently this feature is under test... Will update soon...')
    print(BRIGHT_WHITE +
          '[*] You can use scripts from malwares to manually generate evil files...')

listener_option()

accepts inputs from user to run reverse TCP backdoor and starts listeners

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def listener_option():
    '''accepts inputs from user to run reverse TCP backdoor and starts listeners

    Args:
        None

    Returns:
        None
    '''
    host = input('[+] LHOST : ')
    port = int(input('[+] LPORT : '))
    lsnr = listener.Listener(host, port)
    lsnr.run()

machngr_option()

executes commands to change mac address

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def machngr_option():
    '''executes commands to change mac address

    Args:
        None

    Returns:
        None
    '''
    attacker.mac_changer()

print_help()

prints commands with their brief description.

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def print_help():
    '''
    prints commands with their brief description.

    Args:
        None

    Returns:
        None
    '''
    print(BRIGHT_WHITE + 'Python Hacking Tools (PyHTools) (pht)')

    help = PrettyTable(['Command', 'Description'])
    help.align['Command'] = 'c'
    help.align['Description'] = 'l'
    # help.add_row(['',''])

    help.add_row(['clear', 'clear console'])
    help.add_row(['help', 'display help table'])
    help.add_row(['close', 'exit PyHackingTools'])

    help.add_row(['machngr', 'change mac address of the network interface'])
    help.add_row(['arpspoofer', 'spoof the target by arp poisoning'])
    help.add_row(['nwscan', 'scan for ip range in the network'])

    help.add_row(
        ['webspider', 'maps all the links which are related to root url on the website'])
    help.add_row(
        ['webcrawldirs', 'scan for valid directories of the website using a wordlist'])
    help.add_row(
        ['webcrawlsubdom', 'scan for valid subdomains of the website using a wordlist'])
    help.add_row(['weblogin', 'bruteforce webpage login'])
    help.add_row(['webvulnscan', 'scan for vulnerabilities on the website'])

    # help.add_row(['',''])

    help.add_row(['listener', 'start reverse TCP listener on specific LHOST and LPORT'])
    help.add_row(['sendmail', 'send mail to specific email address'])

    help.add_row(
        ['gen exe', 'generate executables of reverse backdoor, keylogger, etc.'])

    print(help)

run() async

starts PyHTools UI, interacts with user and executes appropriate functions based on command

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

async def run():
    '''starts PyHTools UI, interacts with user and executes appropriate 
    functions based on command 

    Args:
        None

    Returns:
        None
    '''
    try:
        while True:
            cmd = input(BRIGHT_RED + 'pyhtools >>' +
                        RESET_COLORS + ' ').lower().strip()

            # BASIC UI COMMANDS
            if cmd == 'close':
                break

            elif cmd == 'clear':
                clrscr()

            elif cmd == 'help':
                print_help()

            # MALWARES
            elif cmd == 'listener':
                listener_option()

            elif cmd == 'sendmail':
                sendmail_option()

            elif cmd == 'gen exe':
                generate_executable()

            # NETWORK ATTACKERS
            elif cmd == 'machngr':
                machngr_option()

            elif cmd == 'arpspoofer':
                attacker.arpspoofer()

            elif cmd == 'nwscan':
                attacker.nw_scan()

            # WEB ATTACKERS
            elif cmd == 'webspider':
                await attacker.webspider()

            elif cmd == 'webcrawldirs':
                await attacker.webcrawldirs()

            elif cmd == 'webcrawlsubdom':
                await attacker.webcrawlsubdom()

            elif cmd == 'weblogin':
                attacker.brute_login()

            elif cmd == 'webvulnscan':
                attacker.webvulnscan()

            else:
                print(BRIGHT_RED +
                      '[-] Unknown command, use help to view valid commands')

    except (EOFError, KeyboardInterrupt, CancelledError):
        print()
        print(BRIGHT_YELLOW +
              "[\U0001f604] WE ARE NEVER RESPONSIBLE FOR YOUR ACTIONS!")
        print(BRIGHT_RED + '[-] Closing PHT....')
        sys.exit(0)

send_mail_to(email, password, receiver, subject, body)

sends mail to receivers

Parameters:

Name	Type	Description	Default
email	str	email of the sender	required
password	str	password of sender	required
receiver	str	receviever's email address	required
subject	str	email subject	required
body	str	email text content	required

Returns:

Name	Type	Description
bool	bool	returns True if email was sent successfully, else returns False

Source code in pyhtools\UI\functions.py

def send_mail_to(email, password, receiver, subject, body) -> bool:
    '''sends mail to receivers

    Args:
        email (str): email of the sender
        password (str): password of sender
        receiver (str): receviever's email address
        subject (str): email subject
        body (str): email text content

    Returns:
        bool: returns True if email was sent successfully, else returns False
    '''
    print(BRIGHT_WHITE + '[*] Sending email...')
    msg = f'Subject: {subject}\n{body}'
    if send_mail(email, receiver, password, msg):
        print(BRIGHT_YELLOW + '[\u2714] Mail Sent')
    else:
        print(BRIGHT_RED + '[\u274c] Unable to send mail.')

sendmail_option()

Accepts inputs from user to send email

Returns:

Type	Description
	None

Source code in pyhtools\UI\functions.py

def sendmail_option():
    '''Accepts inputs from user to send email

    Args:
        None

    Returns:
        None
    '''
    email = input('[+] gmail acc : ')
    password = input('[+] password : ')
    print('[!] if you want to send mail to yourself enter "self" (without quotes)')
    receiver = input('[+] email to : ')
    if receiver.lower() == 'self':
        receiver = email
    subject = input('[+] subject : ')
    body = input('[+] body : ')
    send_mail_to(email, password, receiver, subject, body)