PyCurrency Compass

PyCurrency Compass is a simple and elegant desktop currency converter application built with Python. It provides real-time exchange rates using a clean, dark-themed user interface.

Features

• Real-Time Conversion: Fetches the latest exchange rates from the ExchangeRate-API.
• User-Friendly Interface: A simple and intuitive GUI built with the customtkinter library.
• Multiple Currencies: Supports conversion between a selection of major world currencies including USD, EUR, GBP, JPY, INR, and more.
• Error Handling: Provides feedback for invalid numerical input.

Getting Started

Prerequisites

• Python 3
• An active internet connection to fetch exchange rates.

Installation

1. Clone the repository:

   git clone https://github.com/rifatsh3ikh/pycurrency-compass.git
   cd pycurrency-compass

2. Install the required Python libraries:

   pip install customtkinter requests

Running the Application

Execute the main.py script to launch the currency converter:

python main.py

How to Use

1. Enter Amount: Type the numerical amount you wish to convert in the input field.
2. Select Currencies:
   • Choose the base currency from the left-hand dropdown menu.
   • Choose the target currency from the right-hand dropdown menu.
3. Convert: Click the "Convert" button.
4. View Result: The converted amount will be displayed at the bottom of the window.

🤝 Contributing

Contributions are welcome! To contribute:

Fork the project

Create a feature branch (git checkout -b feature/your‑idea)

Commit your changes (git commit -m "Add feature")

Push to your branch (git push)

Open a Pull Request

📬 Contact

Maintained by rifatsh3ikh