A Python-based consent-based geolocation awareness dashboard designed for authorized development, testing, and educational purposes.
Developer: negi748
Repository: GeoTracker-Python
- 🐍 Python-based web dashboard
- 🌐 Browser-based interface
- 📍 Consent-based location sharing
- 📷 Optional camera demonstration with explicit permission
- ☁️ Automatic Cloudflare Tunnel integration
- 🔗 Automatic temporary public HTTPS share link
- 📱 Termux (Android) support
- 🐧 Kali Linux support
- 💻 Local dashboard
- 🔐 Privacy-focused usage
- ⚡ Simple command-line startup
Before running the project, make sure you have:
- Python 3
- Git
cloudflared- Modern web browser
- Internet connection
cloudflared must be installed and available to the application for automatic public-link generation.
Run the following command:
git clone https://github.com/negi748/GeoTracker-Python.git && cd GeoTracker-Python && (test -f requirements.txt && pip install -r requirements.txt || true) && python GPS.pyRun:
git clone https://github.com/negi748/GeoTracker-Python.git && cd GeoTracker-Python && (test -f requirements.txt && pip3 install -r requirements.txt || true) && python3 GPS.pygit clone https://github.com/negi748/GeoTracker-Python.gitcd GeoTracker-Pythonpip install -r requirements.txtpip3 install -r requirements.txtpython GPS.pypython3 GPS.pyGeoTracker-Python can automatically use Cloudflare Tunnel to create a temporary public HTTPS URL.
When the application starts, you may see something similar to:
[INFO] Generating public link via Cloudflare Tunnel...
Press CTRL+C to stop...
PUBLIC SHARE LINK:
https://example-name.trycloudflare.com/share/...
No manual tunnel command is required when the automatic tunnel feature is available.
Run GPS.py
↓
Python Web Server
↓
Local Dashboard
↓
Cloudflare Tunnel
↓
Temporary HTTPS URL
↓
PUBLIC SHARE LINK
The application may provide a local dashboard such as:
http://127.0.0.1:8765
A temporary public share link may look like:
https://example-name.trycloudflare.com/share/...
Only share the generated public URL with people who have explicitly agreed to participate.
Update Termux packages:
pkg updateInstall Python and Git:
pkg install python gitClone the repository:
git clone https://github.com/negi748/GeoTracker-Python.gitEnter the project directory:
cd GeoTracker-PythonInstall Python dependencies:
pip install -r requirements.txtStart the application:
python GPS.pyUpdate packages:
sudo apt updateInstall required packages:
sudo apt install python3 python3-pip gitClone the repository:
git clone https://github.com/negi748/GeoTracker-Python.gitEnter the project directory:
cd GeoTracker-PythonInstall dependencies:
pip3 install -r requirements.txtStart the application:
python3 GPS.pyCheck whether cloudflared is installed:
cloudflared --versionOfficial Cloudflare documentation:
A public Cloudflare Tunnel URL can make your local application temporarily accessible from the internet.
Use it responsibly.
- ❌ Do not expose private or sensitive services.
- ❌ Do not publish passwords or API keys.
- ❌ Do not share generated URLs unnecessarily.
- ❌ Do not expose personal information.
- ✅ Stop the application when you are finished.
- ✅ Use
CTRL + Cto stop the application. - ✅ Only share the link with people who have given consent.
GeoTracker-Python is intended for consent-based and authorized use.
Always:
- Get explicit consent before collecting location information.
- Explain what information is being collected.
- Collect only the information necessary for the intended purpose.
- Never secretly track people.
- Never secretly capture photos.
- Never attempt to bypass browser permission controls.
- Never publish private location information.
- Never commit passwords, API keys, or other secrets to GitHub.
Never publish sensitive information inside this repository.
Do not commit:
- API keys
- Passwords
- Authentication tokens
- Private location data
- Personal information
- Cloudflare credentials
- Private configuration files
- Session secrets
Use .gitignore to prevent sensitive files from being committed.
python --versionor:
python3 --versiongit --versioncloudflared --versionlsIf the application does not start, verify that:
- Python 3 is installed.
- Dependencies are installed.
GPS.pyexists.requirements.txtis available when required.cloudflaredis installed if public tunnel functionality is being used.- Your browser allows the requested permissions.
- Your internet connection is working.
GeoTracker-Python/
├── GPS.py
├── README.md
├── .gitignore
└── requirements.txt
Clone the repository:
git clone https://github.com/negi748/GeoTracker-Python.gitCreate a development environment if desired:
python -m venv venvActivate it on Linux/Termux:
source venv/bin/activateInstall dependencies:
pip install -r requirements.txtRun the application:
python GPS.pyContributions, improvements, bug fixes, and educational suggestions are welcome.
Before submitting changes:
- Test your changes locally.
- Keep the project privacy-focused.
- Do not add unauthorized tracking functionality.
- Do not commit secrets or sensitive information.
- Clearly describe your changes.
This project is licensed under the MIT License.
Copyright © 2026 negi748
negi748
GitHub:
https://github.com/negi748
Project:
https://github.com/negi748/GeoTracker-Python
GeoTracker-Python is provided for authorized development, testing, research, and educational purposes.
Use this software only when you have appropriate permission and informed consent from the people whose information may be processed.
The developer is not responsible for misuse of this software or for unlawful tracking, surveillance, privacy violations, or unauthorized data collection.