Phomber

<p align=center> <img src='.images/phomber_logo.png'> </p>

An open source infomation grathering & reconnaissance framework!

<p align=center> <a href='https://www.w3schools.in/ethical-hacking/information-gathering-techniques/'><img src="https://img.shields.io/badge/Etical Hacking-OSINT-yellow.svg?logo=sharp"></a> <a href='https://github.com/s41r4j/phomber/releases/'><img src="https://img.shields.io/badge/Version-v3.1.1-orange.svg?logo=vectorworks"></a> <a href='https://www.python.org/'><img src="https://img.shields.io/badge/Python-3-blue.svg?style=flat&logo=python"></a> <a href='LICENSE'><img src="https://img.shields.io/badge/License-GPL%20v3.0-brightgreen.svg"></a> <a href=''><img src="https://img.shields.io/badge/Disclaimer-With great power comes great responsibility-red.svg?logo=hackaday"></a> </p> <br> <br>

What is PH0MBER?

• PH0MBER is an osint framework, which is one-stop tool for your information gathering and reconnaissance needs
• It can help you gather information (such as phone numbers, ip address, domain name info, etc.) from various publicly available sources about the target

<br> <br>

Quick Guide

Install, Update, Usage

<br>

Installation:

• git clone

git clone https://github.com/s41r4j/phomber
cd phomber
pip3 install -r pyproject.toml

• pip

pip install phomber

• docker

docker pull sinawic/phomber:latest
docker run --rm -it sinawic/phomber:latest

<br>

Update:

• git clone (assuming you are in the phomber directory)

git pull

• pip

pip install --upgrade phomber

• docker

docker pull sinawic/phomber:latest

<br>

Usage:

• git clone (assuming you are in the phomber directory)

python3 phomber.py

• pip

phomber

• docker

phomber

<br>

• Help menu

    ┌────────────────────────────────────────────────────┐
    | COMMANDS      | DESCRIPTION                        |
    |----------------------------------------------------|
    |                 <(Basic Commands)>                 |
    |----------------------------------------------------|
    | help          | Display this help menu             | 
    | exit/quit     | Exit the framework                 |
    | dork          | Show a random google dork query *  |  
    | exp           | Show info about all available      |       
    |               | expressions                        |
    | check         | Check internet connection          |
    | clear         | Clear screen                       |
    | flush         | Flush history                      |
    | save          | Save output of previous scanner    |
    |               | command in a file                  |
    | shell <cmd>   | Execute native shell/cmd commands  |
    | info          | Show info about framework & system |
    | change        | Change user command input color    |
    |----------------------------------------------------|
    |                <(Scanner Commands)>                |
    |----------------------------------------------------|
    | number        | Reverse phone number lookup        |
    | ip            | Reverse ip address lookup *        |
    | mac           | Reverse mac address lookup         |
    | whois         | Reverse whois lookup *             |
    | dns           | Reverse / Normal DNS lookup *      |
    | username      | Username lookup over multiple sites|
    |               | and social media platforms *       |
    └────────────────────────────────────────────────────┘

Pro tips:

• Type help to get a list of commands
• Type help <command> to see more info about a command
• Use Tab key to auto-complete commands
• Try silent mode by using -s/--silent flag
• You can also use Ctrl+C to exit
• Descriptions ending with * needs internet connection
• Use -e/--verbose-errors flag to see more descriptive errors

<br> <br>

NOTES:

- `PH0MBER` is back with all new features and user interface
- `v3` has osint tools with no _api key_ requirement
- Release windows (exe) & linux (lsb) direct executables, no python req.
- `v4` will have web-interface + automated scans features + (custom-scanner feature; create, distribute and deploy your own scanner)

</p>