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.4.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: iptracker-1.0.4.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for iptracker-1.0.4.tar.gz
Algorithm Hash digest
SHA256 533b18d3b705d4de9384d9866e2156051e3826e0a6df6f42a0c57296f0a51738
MD5 14061c82b05ebf86029d925e9bd903e0
BLAKE2b-256 9582753d35b1168bf2d14a914582a3b2d119e28a1bb6a0d9aa365826e454f957

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for iptracker-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 b9bd9ec1f9d824cad4a43fcf296b51dc0ef1f4bb039725392293752e380969ca
MD5 b433f53118b02a867d79b9158a8ae223
BLAKE2b-256 b1e59b2a033dde4e64088cac71c692b92760bfb0f9f3955ff4fdd5da8cf116e8

See more details on using hashes here.

Supported by

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