Merge pull request #32 from sundowndev/develop

Scanning improvements, readme & refactor

README.md

@@ -1,15 +1,35 @@
-# PhoneInfoga
-
-[![Build Status](https://travis-ci.org/sundowndev/PhoneInfoga.svg?branch=master)](https://travis-ci.org/sundowndev/PhoneInfoga)
-![](https://img.shields.io/badge/python-3.6-blue.svg)
-![](https://img.shields.io/github/tag/SundownDEV/PhoneInfoga.svg)
-![](https://img.shields.io/badge/license-MIT-blue.svg)
-
-Information gathering & OSINT reconnaissance tool for phone numbers.
-
-One of the most advanced tools to scan phone numbers using only free resources. The goal is to first gather basic information such as country, area, carrier and line type on any international phone numbers with a very good accuracy. Then try to determine the VoIP provider or search for footprints on search engines to try identify the owner.
-
-### [OSINT Tutorial: Building an OSINT Reconnaissance Tool from Scratch](https://medium.com/@SundownDEV/phone-number-scanning-osint-recon-tool-6ad8f0cac27b)
+<h1 align="center">PhoneInfoga</h1>
+
+<div align="center">
+  <a href="https://travis-ci.org/sundowndev/PhoneInfoga">
+    <img src="https://img.shields.io/travis/sundowndev/PhoneInfoga/master.svg?style=flat-square" alt="Build Status" />
+  </a>
+  <a href="#">
+    <img src="https://img.shields.io/badge/python-3.6-blue.svg?style=flat-square" alt="Python version" />
+  </a>
+  <a href="https://github.com/sundowndev/PhoneInfoga/releases">
+    <img src="https://img.shields.io/github/tag/SundownDEV/PhoneInfoga.svg?style=flat-square" alt="Latest version" />
+  </a>
+  <a href="https://github.com/sundowndev/PhoneInfoga/blob/master/LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="License" />
+  </a>
+</div>
+
+<h4 align="center">Information gathering & OSINT reconnaissance tool for phone numbers</h4>
+
+<div align="center">
+  <sub>For the love of open source investigations. Built with ❤︎ by
+  <a href="https://twitter.com/sundowndev">@sundowndev</a>
+</div>
+
+<h3 align="center">
+  <a href="https://github.com/sundowndev/PhoneInfoga/wiki">Documentation</a> | 
+  <a href="https://medium.com/@SundownDEV/phone-number-scanning-osint-recon-tool-6ad8f0cac27b">OSINT Tutorial</a>
+</h3>
+
+## About
+
+PhoneInfoga is one of the most advanced tools to scan phone numbers using only free resources. The goal is to first gather basic information such as country, area, carrier and line type on any international phone numbers with a very good accuracy. Then try to determine the VoIP provider or search for footprints on search engines to try identify the owner.
 
 ## Features
 

examples/generate.sh

@@ -2,6 +2,12 @@
 
 scriptDir=$(dirname -- "$(readlink -f -- "$BASH_SOURCE")")
 
+python3 $scriptDir/../phoneinfoga.py -n "+86 591 2284 8571" -h
+
+python3 $scriptDir/../phoneinfoga.py -n "+86 591 2284 8571" -s any --no-ansi
+
 python3 $scriptDir/../phoneinfoga.py -i $scriptDir/input.txt -o $scriptDir/output_from_input.txt -s any
 
 python3 $scriptDir/../phoneinfoga.py -n "+86 591 2284 8571" -s all -o $scriptDir/output_single.txt
+
+echo "Test script executed."

examples/output_from_input.txt

@@ -4,90 +4,84 @@
  / ___/| | | | (_) | | | |  __/\/ /_ | | | |  _| (_) | (_| | (_| |
  \/    |_| |_|\___/|_| |_|\___\____/ |_| |_|_|  \___/ \__, |\__,_|
                                                       |___/       
- PhoneInfoga Ver. v1.1.0-rc1
+ PhoneInfoga Ver. v1.0.0
  Coded by Sundowndev
 
 
 [!] ---- Fetching informations for 8562099453217 ---- [!]
-[*] Running local scan...
+[-] Running local scan...
 [+] International format: +856 20 99 453 217
 [+] Local format: 02099453217
-[+] Country code: +856
-[+] Location: Laos
+[+] Country found: Laos (+856)
+[+] City/Area: Laos
 [+] Carrier: Unitel
-[+] Area: Laos
 [+] Timezone: Asia/Vientiane
-[*] The number is valid and possible.
-[*] Scan finished.
+[-] The number is valid and possible.
+[-] Scan finished.
 
 
 [!] ---- Fetching informations for 59172768361 ---- [!]
-[*] Running local scan...
+[-] Running local scan...
 [+] International format: +591 72768361
 [+] Local format: 072768361
-[+] Country code: +591
-[+] Location: Bolivia
+[+] Country found: Bolivia (+591)
+[+] City/Area: Bolivia
 [+] Carrier: Entel
-[+] Area: Bolivia
 [+] Timezone: America/La_Paz
-[*] The number is valid and possible.
-[*] Scan finished.
+[-] The number is valid and possible.
+[-] Scan finished.
 
 
 [!] ---- Fetching informations for 32474123456 ---- [!]
-[*] Running local scan...
+[-] Running local scan...
 [+] International format: +32 474 12 34 56
 [+] Local format: 0474123456
-[+] Country code: +32
-[+] Location: Belgium
+[+] Country found: Belgium (+32)
+[+] City/Area: Belgium
 [+] Carrier: Proximus
-[+] Area: Belgium
 [+] Timezone: Europe/Brussels
-[*] The number is valid and possible.
-[*] Scan finished.
+[-] The number is valid and possible.
+[-] Scan finished.
 
 
 [!] ---- Fetching informations for 15417543010 ---- [!]
-[*] Running local scan...
+[-] Running local scan...
 [+] International format: +1 541-754-3010
 [+] Local format: 05417543010
-[+] Country code: +1
-[+] Location: Corvallis, OR
+[+] Country found: United States (+1)
+[+] City/Area: Corvallis, OR
 [+] Carrier: 
-[+] Area: Corvallis, OR
 [+] Timezone: America/Los_Angeles
-[*] The number is valid and possible.
-[*] Scan finished.
+[-] The number is valid and possible.
+[-] Scan finished.
 
 
 [!] ---- Fetching informations for 8659122848571 ---- [!]
-[*] Running local scan...
+[-] Running local scan...
 [+] International format: +86 591 2284 8571
 [+] Local format: 059122848571
-[+] Country code: +86
-[+] Location: Fuzhou, Fujian
+[+] Country found: China (+86)
+[+] City/Area: Fuzhou, Fujian
 [+] Carrier: 
-[+] Area: Fuzhou, Fujian
 [+] Timezone: Asia/Shanghai
-[*] The number is valid and possible.
-[*] Scan finished.
+[-] The number is valid and possible.
+[-] Scan finished.
 
 
 [!] ---- Fetching informations for 74964819375 ---- [!]
-[*] Running local scan...
+[-] Running local scan...
 [+] International format: +7 496 481-93-75
 [+] Local format: 04964819375
-[+] Country code: +7
-[+] Location: Moscow
+[+] Country found: Russia (+7)
+[+] City/Area: Moscow
 [+] Carrier: 
-[+] Area: Moscow
 [+] Timezone: Europe/Moscow
-[*] The number is valid and possible.
-[*] Scan finished.
+[-] The number is valid and possible.
+[-] Scan finished.
 
 
 [!] ---- Fetching informations for 39172768361 ---- [!]
-[*] Running local scan...
-[*] Scan finished.
+[-] Running local scan...
+[-] Scan finished.