# 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:
```bash
pip install iptracker
```
## Usage
```python
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:
```python
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
"""
```
```python
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](LICENSE) file for details.
## Contact
For any inquiries or support, please contact us at Ishan.kodithuwakku.official@gmail.com
**Repository Views** 
Raw data
{
"_id": null,
"home_page": "https://github.com/ishanoshada/iptracker",
"name": "iptracker",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Ishan Oshada",
"author_email": "ishan.kodithuwakku.official@email.com",
"download_url": "https://files.pythonhosted.org/packages/95/82/753d35b1168bf2d14a914582a3b2d119e28a1bb6a0d9aa365826e454f957/iptracker-1.0.4.tar.gz",
"platform": null,
"description": "\n# IPTracker\n\n\nIPTracker is a versatile Python library and service that allows you to track and analyze IP addresses, providing valuable insights into user activity and location.\n\n## Features\n\n- **User Account Management:** Easily create and manage user accounts to track IP addresses.\n- **Secure Authentication:** Password-protected accounts ensure secure access to tracking data.\n- **Generate Tracking Links:** Generate unique tracking links to monitor user interactions.\n- **IP Location Lookup:** Retrieve detailed information about the geographical location of IP addresses.\n- **Real-Time Data Processing:** Continuously monitor and process IP tracking data in real-time.\n- **Customizable Settings:** Tailor settings to your preferences, including location tracking and data processing intervals.\n\n## Installation\n\nYou can install IPTracker via pip:\n\n```bash\npip install iptracker\n```\n\n## Usage\n\n```python\nfrom iptracker import IPTracker\n\n# Initialize IPTracker with your credentials\nusername = \"your_username\"\npassword = \"your_password\"\nredirect_url = \"/\"\ntracker = IPTracker(username, password, redirect_url)\n\n# Create an account\n# print(tracker.create_account())\n\n# Login\n# print(tracker.login())\n\n# Generate a tracking link\ntracking_link = tracker.generate_link()\nprint(\"Tracking Link:\", tracking_link)\n\n# Retrieve data from the tracking link\n# Replace the example URL with your generated tracking link\n# tracker.link_data(\"https://xxxxxxxx.com/link/your_tracking_key\")\n```\n\n## Example\n\nCheck out this example to see how IPTracker can be used to monitor user interactions:\n\n```python\nfrom iptracker import IPTracker\n\n# Initialize IPTracker with your credentials\nusername = \"your_username\"\npassword = \"your_password\"\nredirect_url = \"https://github.com/Ishanoshada/iptracker/\"\ntracker = IPTracker(username, password, redirect_url,location=True)\n\n# Create an account\n# print(tracker.create_account())\n\n# Login\n# print(tracker.login())\n\n# Generate a tracking link\ntracking_link = tracker.generate_link()\nprint(\"Tracking Link:\", tracking_link)\n\n# Retrieve data from the tracking link\n# Replace the example URL with your generated tracking link\ntracker.link_data(tracking_link)\n\"\"\"Processing Link Data...\n\n\nIP: 127, Timestamp: Thu, 22 Feb 2024 12:05:48, User Agent: Mozilla/5.0 (Linux; 37.36\n\nIP Information:\nIP Address: 1..237\nCity: \nRegion: \nCountry: \nLocation: 6.65\nOrganization: AS180a PLC.\nPostal Code: \nTimezone: Asi\n\n\"\"\"\n\n```\n\n```python\nfrom iptracker import main\n\nmain() #interface\n\"\"\"\nHere's how you can interact with the improved IP Tracker script:\n\n1. Run the script.\n2. Enter your credentials when prompted (username, password, redirect URL).\n3. Choose options from the menu:\n\n - **Create Account (1)**: Creates an account with the provided credentials.\n - **Login (2)**: Logs into the account.\n - **Generate Link (3)**: Generates a tracking link.\n - **Track Link Data (4)**: Tracks data for a specific link.\n - **Exit (5)**: Exits the program.\n\nExample interaction:\n\n \n\nWelcome to the IP Tracker!\nPlease enter your credentials:\nUsername: my_username\nPassword: my_password\nRedirect URL: https://example.com\nDo you want to track IP location? (Y/N): Y\n\nMenu:\n1. Create Account\n2. Login\n3. Generate Link\n4. Track Link Data\n5. Exit\nEnter your choice (1-5): 3\nGenerated link: https://bbbbbbbb-three.vercel.app/link/123456\n\nMenu:\n1. Create Account\n2. Login\n3. Generate Link\n4. Track Link Data\n5. Exit\nEnter your choice (1-5): 4\nEnter the link URL: https://bbbbbbbb-three.vercel.app/link/123456\n\nProcessing Link Data...\nIP: 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\n\nIP Information:\nIP Address: 123.456.789.0\nCity: CityName\nRegion: RegionName\nCountry: CountryName\nLocation: Latitude, Longitude\nOrganization: OrganizationName\nPostal Code: PostalCode\nTimezone: TimezoneName\n\nMenu:\n1. Create Account\n2. Login\n3. Generate Link\n4. Track Link Data\n5. Exit\nEnter your choice (1-5): 5\nExiting program...\n\nThis example demonstrates creating an account, generating a tracking link, and tracking data for that link. You can explore other options similarly.\n\"\"\"\n\n\n\n```\n\n## Contributing\n\nWe welcome contributions from the community! Feel free to submit bug reports, feature requests, or pull requests to help improve IPTracker.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor any inquiries or support, please contact us at Ishan.kodithuwakku.official@gmail.com\n\n**Repository Views** \n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python package for tracking IP addresses and their locations.",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/ishanoshada/iptracker"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b1e59b2a033dde4e64088cac71c692b92760bfb0f9f3955ff4fdd5da8cf116e8",
"md5": "b433f53118b02a867d79b9158a8ae223",
"sha256": "b9bd9ec1f9d824cad4a43fcf296b51dc0ef1f4bb039725392293752e380969ca"
},
"downloads": -1,
"filename": "iptracker-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b433f53118b02a867d79b9158a8ae223",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5721,
"upload_time": "2025-02-02T15:27:55",
"upload_time_iso_8601": "2025-02-02T15:27:55.380711Z",
"url": "https://files.pythonhosted.org/packages/b1/e5/9b2a033dde4e64088cac71c692b92760bfb0f9f3955ff4fdd5da8cf116e8/iptracker-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9582753d35b1168bf2d14a914582a3b2d119e28a1bb6a0d9aa365826e454f957",
"md5": "14061c82b05ebf86029d925e9bd903e0",
"sha256": "533b18d3b705d4de9384d9866e2156051e3826e0a6df6f42a0c57296f0a51738"
},
"downloads": -1,
"filename": "iptracker-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "14061c82b05ebf86029d925e9bd903e0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5318,
"upload_time": "2025-02-02T15:27:57",
"upload_time_iso_8601": "2025-02-02T15:27:57.757880Z",
"url": "https://files.pythonhosted.org/packages/95/82/753d35b1168bf2d14a914582a3b2d119e28a1bb6a0d9aa365826e454f957/iptracker-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-02 15:27:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ishanoshada",
"github_project": "iptracker",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "iptracker"
}
JSON
