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.py

Run:

git clone https://github.com/negi748/GeoTracker-Python.git && cd GeoTracker-Python && (test -f requirements.txt && pip3 install -r requirements.txt || true) && python3 GPS.py

git clone https://github.com/negi748/GeoTracker-Python.git

cd GeoTracker-Python

pip install -r requirements.txt

pip3 install -r requirements.txt

python GPS.py

python3 GPS.py

GeoTracker-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 update

Install Python and Git:

pkg install python git

Clone the repository:

git clone https://github.com/negi748/GeoTracker-Python.git

Enter the project directory:

cd GeoTracker-Python

Install Python dependencies:

pip install -r requirements.txt

Start the application:

python GPS.py

Update packages:

sudo apt update

Install required packages:

sudo apt install python3 python3-pip git

Clone the repository:

git clone https://github.com/negi748/GeoTracker-Python.git

Enter the project directory:

cd GeoTracker-Python

Install dependencies:

pip3 install -r requirements.txt

Start the application:

python3 GPS.py

Check whether cloudflared is installed:

cloudflared --version

Official Cloudflare documentation:

https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/do-more-with-tunnels/trycloudflare/

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 + C to 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 --version

or:

python3 --version

git --version

cloudflared --version

ls

If the application does not start, verify that:

• Python 3 is installed.
• Dependencies are installed.
• GPS.py exists.
• requirements.txt is available when required.
• cloudflared is 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.git

Create a development environment if desired:

python -m venv venv

Activate it on Linux/Termux:

source venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Run the application:

python GPS.py

Contributions, improvements, bug fixes, and educational suggestions are welcome.

Before submitting changes:

1. Test your changes locally.
2. Keep the project privacy-focused.
3. Do not add unauthorized tracking functionality.
4. Do not commit secrets or sensitive information.
5. 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.