Skip to main content

A Python package for tracking IP addresses and their locations.

Project description

IPTracker

IPTracker is a versatile Python library and service that allows you to track and analyze IP addresses, providing valuable insights into user activity and location.

Features

  • User Account Management: Easily create and manage user accounts to track IP addresses.
  • Secure Authentication: Password-protected accounts ensure secure access to tracking data.
  • Generate Tracking Links: Generate unique tracking links to monitor user interactions.
  • IP Location Lookup: Retrieve detailed information about the geographical location of IP addresses.
  • Real-Time Data Processing: Continuously monitor and process IP tracking data in real-time.
  • Customizable Settings: Tailor settings to your preferences, including location tracking and data processing intervals.

Installation

You can install IPTracker via pip:

pip install iptracker

Usage

from iptracker import IPTracker

# Initialize IPTracker with your credentials
username = "your_username"
password = "your_password"
redirect_url = "/"
tracker = IPTracker(username, password, redirect_url)

# Create an account
# print(tracker.create_account())

# Login
# print(tracker.login())

# Generate a tracking link
tracking_link = tracker.generate_link()
print("Tracking Link:", tracking_link)

# Retrieve data from the tracking link
# Replace the example URL with your generated tracking link
# tracker.link_data("https://xxxxxxxx.com/link/your_tracking_key")

Example

Check out this example to see how IPTracker can be used to monitor user interactions:

from iptracker import IPTracker

# Initialize IPTracker with your credentials
username = "your_username"
password = "your_password"
redirect_url = "https://github.com/Ishanoshada/iptracker/"
tracker = IPTracker(username, password, redirect_url,location=True)

# Create an account
# print(tracker.create_account())

# Login
# print(tracker.login())

# Generate a tracking link
tracking_link = tracker.generate_link()
print("Tracking Link:", tracking_link)

# Retrieve data from the tracking link
# Replace the example URL with your generated tracking link
tracker.link_data(tracking_link)
"""Processing Link Data...


IP: 127, Timestamp: Thu, 22 Feb 2024 12:05:48, User Agent: Mozilla/5.0 (Linux; 37.36

IP Information:
IP Address: 1..237
City: 
Region: 
Country: 
Location: 6.65
Organization: AS180a PLC.
Postal Code: 
Timezone: Asi

"""
from iptracker import main

main() #interface
"""
Here's how you can interact with the improved IP Tracker script:

1. Run the script.
2. Enter your credentials when prompted (username, password, redirect URL).
3. Choose options from the menu:

    - **Create Account (1)**: Creates an account with the provided credentials.
    - **Login (2)**: Logs into the account.
    - **Generate Link (3)**: Generates a tracking link.
    - **Track Link Data (4)**: Tracks data for a specific link.
    - **Exit (5)**: Exits the program.

Example interaction:

                                   

Welcome to the IP Tracker!
Please enter your credentials:
Username: my_username
Password: my_password
Redirect URL: https://example.com
Do you want to track IP location? (Y/N): Y

Menu:
1. Create Account
2. Login
3. Generate Link
4. Track Link Data
5. Exit
Enter your choice (1-5): 3
Generated link: https://bbbbbbbb-three.vercel.app/link/123456

Menu:
1. Create Account
2. Login
3. Generate Link
4. Track Link Data
5. Exit
Enter your choice (1-5): 4
Enter the link URL: https://bbbbbbbb-three.vercel.app/link/123456

Processing Link Data...
IP: 123.456.789.0, Timestamp: 2024-02-25 12:34:56, User Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.9000.0 Safari/537.36

IP Information:
IP Address: 123.456.789.0
City: CityName
Region: RegionName
Country: CountryName
Location: Latitude, Longitude
Organization: OrganizationName
Postal Code: PostalCode
Timezone: TimezoneName

Menu:
1. Create Account
2. Login
3. Generate Link
4. Track Link Data
5. Exit
Enter your choice (1-5): 5
Exiting program...

This example demonstrates creating an account, generating a tracking link, and tracking data for that link. You can explore other options similarly.
"""

Contributing

We welcome contributions from the community! Feel free to submit bug reports, feature requests, or pull requests to help improve IPTracker.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For any inquiries or support, please contact us at Ishan.kodithuwakku.official@gmail.com

Repository Views Views

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iptracker-1.0.3.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

iptracker-1.0.3-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file iptracker-1.0.3.tar.gz.

File metadata

  • Download URL: iptracker-1.0.3.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.18

File hashes

Hashes for iptracker-1.0.3.tar.gz
Algorithm Hash digest
SHA256 2f9d835709101beea288ce9a617c1e4719d66288a0ef959014a4873574f31698
MD5 3d15c3959f05bf47d7dad58ad6c11b76
BLAKE2b-256 34b61f0d667d9a48aa13392caae8865fd354ea35b29bb71084b3584e8cd9a2dd

See more details on using hashes here.

File details

Details for the file iptracker-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: iptracker-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 5.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.18

File hashes

Hashes for iptracker-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 2db139f5d10d017c047f22de1c4ca88d754dda9305d1f10201e86338c33f812d
MD5 753e108680c1d8ad4b614a4a620d3049
BLAKE2b-256 b960e9e87603c5c089878a4c71464d596e9ab5691e126d33663a2dfa26289183

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page