A Python-based tool to track phone number details and geolocation information. This project uses the phonenumbers library to parse phone numbers and extract location and carrier details, and OpenCageGeocode to retrieve geographic information.
-
Phone Number Parsing:
Extracts location and carrier information from phone numbers. -
Geocoding:
Retrieves latitude, longitude, timezone, currency, and flag data using the OpenCageGeocode API. -
Mapping Integration:
Opens the location in Google Maps (or Apple Maps, if desired) directly from your terminal. -
Robust Error Handling & Logging:
Captures errors and logs important events inapp.logfor easier debugging. -
Data Persistence:
Saves lookup history with timestamps inlookup_history.txt.
- Python 3.6 or higher
-
Clone the Repository
Clone the repository and install the dependencies using the providedrequirements.txt:git clone https://github.com/jaikanthh/phone-tracker.git cd phone-tracker -
Create a Virtual Environment (Optional but recommended)
Set up a virtual environment to manage dependencies:python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install Dependencies
Install the required Python packages:pip install -r requirements.txt
-
Run The FIle Run Tracker.py file
Obtain an API key from OpenCage Geocoder and open file named API.py in the project directory with the following content:
# API.py
key = "YOUR_OPENCAGE_API_KEY"Run the main script:
python main.pyWhen prompted, enter the phone number (with country code). The tool will then:
- Display the phone number's location and carrier information.
- Retrieve and display detailed geographic information.
- Open the corresponding location in your default web browser via Google Maps (or Apple Maps).
This project is licensed under the MIT License. See the LICENSE file for more information.
For questions, suggestions, or issues, please reach out: