https://github.com/mmabiaa/currency-converter
This is a simple currency converter built using python tkinter
https://github.com/mmabiaa/currency-converter
currency-converter currency-exchange-rates python tkinter
Last synced: 6 months ago
JSON representation
This is a simple currency converter built using python tkinter
- Host: GitHub
- URL: https://github.com/mmabiaa/currency-converter
- Owner: Mmabiaa
- Created: 2024-07-22T23:58:09.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-23T22:29:21.000Z (9 months ago)
- Last Synced: 2025-03-29T06:51:18.750Z (7 months ago)
- Topics: currency-converter, currency-exchange-rates, python, tkinter
- Language: Python
- Homepage:
- Size: 31.3 KB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: Readme.md
- Contributing: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Currency Converter
Welcome to the **Currency Converter** application! This project is a simple yet effective tool for converting between various currencies using Python's Tkinter library for the graphical user interface (GUI).
## Features
- **Multi-Currency Support**: Convert between USD, GHC, EUR, GBP, JPY, and CFA.
- **User-Friendly Interface**: Intuitive GUI that allows users to easily input amounts and select currencies.
- **Real-Time Conversion**: Quickly see the converted amount with a click of a button.
- **Error Handling**: Robust error handling to manage invalid inputs gracefully.
## Installation
To get started with the Currency Converter application, follow these steps:
### Prerequisites
- Ensure you have Python 3.x installed on your machine. You can download it from [python.org](https://www.python.org/downloads/).
### Steps to Install
1. **Clone the Repository**:
Open your terminal or command prompt and run:
`git clone https://github.com/mmabiaa/currency-converter.git`
2. **Navigate to the Project Directory**:
`cd currency-converter`
3. **Get Your Api Key**:
Visit below link and sign up to get api key
`https://apilayer.com/marketplace/exchangerates_data-api?utm_source=apilayermarketplace&utm_medium=featured`
4. **Place your api key**
goto `converter.py` and in line 7 place your api key
`"apikey": ""`
5. **Run the Application**:
Execute the following command:
`python main.py`
## Usage
1. **Input Amount**: Enter the amount you wish to convert in the designated field.
2. **Select Currencies**: Use the dropdown menus to select the source currency (From) and the target currency (To).
3. **Convert**: Click on the "Convert" button to see the converted amount displayed below.
4. **View Result**: The converted amount will be shown in a user-friendly format.
## Example
If you want to convert 100 USD to GHC, simply enter `100`, select `USD` from the "From Currency" dropdown, and `GHC` from the "To Currency" dropdown, then click "Convert". The result will display as `Converted Amount: 1524.00`.
## Contributing
We welcome contributions from everyone! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for detailed guidelines on how to contribute to this project.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contact
For any inquiries or suggestions, please contact us at [Mmabiaa](isbbydior@gmail.com). You can also reach out through our GitHub issues page for support.