{"id":24163274,"url":"https://github.com/hackfutsec/bitz-locator","last_synced_at":"2025-03-02T05:43:05.690Z","repository":{"id":266940203,"uuid":"899820606","full_name":"HackfutSec/Bitz-Locator","owner":"HackfutSec","description":"Bitz Pro Location 2.0 ","archived":false,"fork":false,"pushed_at":"2024-12-28T08:14:12.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-12T18:17:05.187Z","etag":null,"topics":["cyber-security","cybersecurity","linux-tools","localization","locator-map","locator-number","number","tools","windows-tools"],"latest_commit_sha":null,"homepage":"https://github.com/HackfutSec/Bitz-Locator.git","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HackfutSec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-07T05:19:19.000Z","updated_at":"2024-12-28T08:14:16.000Z","dependencies_parsed_at":"2024-12-07T06:24:49.114Z","dependency_job_id":"bd3bb457-d99f-4a06-8bbe-3a9f89cf0a3e","html_url":"https://github.com/HackfutSec/Bitz-Locator","commit_stats":null,"previous_names":["hackfutsec/bitz-locator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FBitz-Locator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FBitz-Locator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FBitz-Locator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackfutSec%2FBitz-Locator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HackfutSec","download_url":"https://codeload.github.com/HackfutSec/Bitz-Locator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241465082,"owners_count":19967243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cyber-security","cybersecurity","linux-tools","localization","locator-map","locator-number","number","tools","windows-tools"],"created_at":"2025-01-12T18:17:14.558Z","updated_at":"2025-03-02T05:43:05.664Z","avatar_url":"https://github.com/HackfutSec.png","language":"Python","readme":"# 📍 **Bitz Locator**  \n\n## 📚 **Description**  \n**Bitz Locator** is a Python-based phone number geolocation tool that retrieves and displays detailed information about a phone number, including location, carrier, and a visual map representation. Powered by OpenCage API, this tool offers precise geolocation data for security auditing and research purposes.  \n\n---\n\n## ⚙️ **Features**  \n- ✅ **Phone Number Geolocation:** Get detailed information about a phone number's approximate location.  \n- ✅ **Carrier Information:** Identify the service provider associated with the phone number.  \n- ✅ **Map Integration:** Generate an interactive map using Folium.  \n- ✅ **Google Maps Integration:** Direct access to the location via Google Maps.  \n- ✅ **API Integration:** OpenCage Geocode API for accurate data retrieval.  \n\n---\n\n## 🚀 **Installation**  \n\n1. **Clone the Repository:**  \n   ```bash\n   git clone https://github.com/HackfutSec/Bitz-Locator.git\n   cd Bitz-Locator\n   ```\n\n2. **Ensure Python is Installed:**  \n   ```bash\n   python --version\n   ```\n\n3. **Install Required Dependencies:**  \n   ```bash\n   pip install -r requirements.txt\n   ```\n\n---\n\n## 🛠️ **Usage**  \n\n1. **Run the Script:**  \n   ```bash\n   python bitz_locator.py\n   ```\n\n2. **Provide Information:**  \n   - Enter the phone number in international format (e.g., `+1XXXXXXXXXX`).  \n   - Provide a valid **OpenCage API key**.  \n\n3. **Output Includes:**  \n   - Location details (Country, City, Latitude, Longitude).  \n   - Service Provider information.  \n   - An interactive HTML map saved as `cartefound.html`.  \n   - A direct Google Maps link to the location.  \n\n4. **Open the Map:**  \n   ```bash\n   open cartefound.html\n   ```\n\n---\n\n## 🔑 **API Key**  \n- You will need a valid **OpenCage API Key**.  \n- Get one from [OpenCage Geocoding API](https://opencagedata.com/).  \n\n---\n\n## 📊 **Dependencies**  \n- `phonenumbers`  \n- `folium`  \n- `opencage`  \n- `requests`  \n\nInstall them via:  \n```bash\npip install phonenumbers folium opencage requests\n```\n\n---\n\n## 🔒 **Disclaimer**  \n⚠️ **This tool is intended for educational and security research purposes only.**  \nThe author assumes no responsibility for misuse or malicious activities.  \n\n---\n\n## 📞 **Contact**  \n- **Author:** Hackfut  \n- **Telegram:** [t.me/HackfutSec](https://t.me/HackfutSec)  \n\n---\n\n## 📄 **License**  \nThis project is licensed under the **MIT License**. See the `LICENSE` file for details.  \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackfutsec%2Fbitz-locator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackfutsec%2Fbitz-locator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackfutsec%2Fbitz-locator/lists"}