Git Product home page Git Product logo

geocipher's Introduction

GeoCipher

GeoCipher

GeoCipher is a Python application that allows you to retrieve geographical information based on IP addresses and coordinates (latitude and longitude). This tool provides a user-friendly graphical interface using PyQt6, making it easy to use.

Features

IP Geolocation: Enter an IP address, and GeoCipher will fetch its geographical details, including latitude, longitude, city, and country.

Coordinate Geolocation: Input latitude and longitude in a comma-separated format, and GeoCipher will provide information such as the city, street, and country.

User Interface: GeoCipher offers a simple and intuitive graphical user interface (GUI) for effortless interaction.

Results Display: The tool displays the results in a separate window with animated text for a user-friendly experience.

Prerequisites

Before running GeoCipher, make sure you have the following dependencies installed:

Python 3.x

PyQt6

requests

Installation Requirements

To get started with GeoCipher, follow these simple steps:

  1. Clone this repository to your local machine.

  2. Install PyQt6 & requests if you haven't already:

    pip install PyQt6 requests
    

Getting Started

Clone the repository to your local machine:

bash git clone https://github.com/jumbubly/GeoCipher.git

Change to the project directory:

bash cd GeoCipher

Run the GeoCipher application:

bash python geocipher.py

The GUI will open, and you can start using GeoCipher to retrieve geographical data.

Usage

IP Geolocation: To get geographical data based on an IP address, follow these steps:

a. Enter the IP address in the "Enter IP Address" field.

b. Click the "Get IP Data" button.

c. The results will be displayed in a separate window.

Coordinate Geolocation: To retrieve geographical data using latitude and longitude, follow these steps:

a. Enter the latitude and longitude in the "Enter Latitude and Longitude" field, separated by a comma.

b. Click the "Get Coordinate Data" button.

c. The results will be displayed in a separate window.

Reset Data: Click the "Reset Data" button to clear the input fields.

Screenshots

IP Geolocation

Coordinate Geolocation

Contributing

If you want to contribute to this project, please follow these steps:

Fork the repository on GitHub.

Create a new branch with a descriptive name for your feature or bug fix.

Make your changes and commit them with clear messages.

Push your branch to your forked repository.

Create a pull request to the main repository's master branch.

Wait for feedback and approval from the maintainers.

License

This project is protected by copyright, and all rights are reserved. Unauthorized use, reproduction, or distribution of this code or any associated materials is prohibited.

Acknowledgments

This project was created by ReKing.

Disclaimer

This tool is provided for educational and informational purposes only. Please use it responsibly and ensure compliance with all relevant laws and regulations when using geographical data.

Enjoy using GeoCipher! If you encounter any issues or have suggestions for improvement, feel free to open an issue on GitHub.

geocipher's People

Contributors

jumbubly avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.